NewBeeMall 新蜂商城：一套 Java 跑通前后端，自带 575 件商品开箱即用

做电商系统二次开发，最怕碰上两类源码：一类是微服务全家桶，动辄 Nacos、Sentinel、Gateway、Seata，本地开 16G 内存还卡在服务注册上；另一类是前后端分离的大型单体，前端 npm install 报一堆 node-sass、node-gyp 版本冲突，还没看到页面就耗掉半天。很多时候我们只是需要一套结构干净、能跑通完整交易闭环的独立电商程序，把数据和业务逻辑握在自己手里。

NewBeeMall（新蜂商城）走的是一条极其省心的路线：全套系统基于 Spring Boot 2.7 + Thymeleaf + MyBatis + MySQL，把前台商城和后台管理合并在同一个 Java 工程里。前台采用纯服务端渲染的 HTML 模板，没有单独的前端脚手架，不需要装 Node 或跑 npm 构建。更关键的是它自带完整的初始数据：MySQL 脚本一键导入 9 张数据表、575 件现成商品、92 个多级分类、20 笔示例订单以及 705 张真实商品图片。

在 Windows 11 与 Linux（WSL2 Ubuntu 26.04）双环境下进行了全量实测。Spring Boot fat jar 构建成功仅 59MB，导入数据库耗时 2.37 秒，Java 服务启动仅需 3.35 秒，首页首屏渲染耗时 0.19 秒，前后台 10 个核心页面请求 HTTP 均为 200，控制台 0 个 JS 报错。当然，它不是全能的：纯 PC 固定栅格布局、图片上传目录写死在常量里等细节，在生产部署时都有讲究，哪几类人不适合用在文末会有单独说明。

它是什么，和微服务电商差在哪

• 技术栈：Spring Boot 2.7.5 + Thymeleaf + MyBatis + MySQL 8（亦兼容 5.7）
• 单工程双入口：前台商城与后台管理由同一个服务提供，无需微服务中间件
• 种子数据齐全：内置 9 张表、575 件商品、92 个分类、20 笔示例订单、4 个前台会员与 3 个管理员
• 静态图片本地化：随附 705 张实测商品图（26MB），无需配置第三方云对象存储
• 授权协议：GPL-3.0 协议，适合内部系统二次开发或独立建站

很多开发者看电商架构图，满屏都是分布式事务、消息队列和服务熔断。那些方案是为十万级并发设计的，放在中小型独立商城或自用业务里，维护成本远超业务收益。NewBeeMall 的特点就是做减法：不用分布式架构，不用前端工程化编译，所有的 HTML 页面都由 Thymeleaf 在后端直接拼装输出。一个打包好的 Spring Boot fat jar，配上一个 MySQL 数据库，本地分配 1GB 内存就能完整跑起来。

我的测试环境

• Windows 11 本机：Temurin JDK 17.0.20.1+1，Apache Maven 3.9.16，MySQL 8.0.29
• Linux 环境：WSL2 Ubuntu 26.04（内核 6.18），OpenJDK 17.0.2，Apache Maven 3.9.9，MySQL 8.0.29
• 运行服务：Spring Boot 独立运行（内嵌 Tomcat），Windows 端口 28089，Linux 端口 28090
• 截图规格：桌面端 1400 宽、deviceScaleFactor 1、全屏完整页面；手机端 390 宽、deviceScaleFactor 2，共 10 张
• 成品体积：打包归档 85.7MB，包含预编译 fat jar、数据库脚本、完整源码以及 705 张商品图

安装：Windows 本地快速起站

第 1 步：建库并导入数据

打开系统命令行窗口，先在 MySQL 中创建专属数据库：

CREATE DATABASE newbee_mall_db DEFAULT CHARACTER SET utf8mb4;

随后将随包附带的建表与初始化数据脚本导入。在命令行中使用重定向方式执行导入：

mysql -uroot -p你的密码 --default-character-set=utf8mb4 newbee_mall_db < newbee_mall_schema.sql

注意字符集务必指定为 utf8mb4，避免商品名称中的特殊字符造成插入截断。实测导入 9 张表、575 件商品及关联数据耗时 2.37 秒。

第 2 步：解压商品图片到本地磁盘

程序中配置的商品图片访问路径映射自本地磁盘目录。需要将包内 resources 目录下的商品图片压缩文件解压出来：

Expand-Archive .\src\main\resources\upload.zip -DestinationPath $env:TEMP\nbm -Force
New-Item -ItemType Directory -Force D:\upload | Out-Null
Copy-Item "$env:TEMP\nbm\upload\*" D:\upload -Force

需要特别留意：压缩包内本身嵌有一层 upload 文件夹，解压时需将内层文件直接平铺至 D 盘的 upload 目录中。若目录层级放错，前台首页能正常打开，但商品图片接口将全部返回 404。

第 3 步：运行预编译可执行文件

在命令行直接启动打包好的 fat jar，并通过命令行参数指定数据库连接密码：

java -jar newbee-mall-1.0.0-SNAPSHOT.jar --spring.datasource.password=你的密码

当控制台输出 Started NewBeeMallApplication in 3.353 seconds 提示后，即表明服务已成功就绪。打开本地浏览器，直接访问前台首页：

前台地址：http://127.0.0.1:28089/

安装：Linux 服务器环境部署

在 Linux 服务器环境下部署，核心流程与本地基本相同，但需要处理文件路径差异：

第 1 步：调整图片存储常量与代码编译

源码中商品图片路径默认为 Windows 绝对路径格式。在 Linux 侧部署前，打开常量定义源码文件：

src/main/java/ltd/newbee/mall/common/Constants.java

将文件中的目录常量由 Windows 路径修改为 Linux 本地路径（例如 /opt/image/upload/），并在系统中创建对应目录将图片解压平铺进去。修改完成后使用 Maven 进行打包编译：

mvn -B -DskipTests clean package

构建过程约耗时两分钟，会在 target 目录下生成 59MB 的单一可执行 jar 文件。

第 2 步：后台常驻运行与探活

在服务器中通过 nohup 命令将商城服务置于后台运行：

nohup java -jar target/newbee-mall-1.0.0-SNAPSHOT.jar --server.port=28090 --spring.datasource.password=你的密码 > mall.log 2>&1 &

检查日志确认端口绑定成功后，使用命令行探活：

curl -s -o /dev/null -w "%{http_code} %{time_total}s\n" http://127.0.0.1:28090/

实测终端输出 200 0.046s，表明服务在 Linux 侧稳定运行，首页毫秒级响应。

建站上手：三步跑通电商核心流程

第一步：商品搜索与分类筛选

访问前台首页后，顶部展示多级类目导航栏，中部为轮播广告与主推商品，下方展示新品推荐与热卖榜单。在搜索框中输入关键词（如输入 MUJI 或华为），系统会在 0.2 秒内服务端渲染出多重维度的商品搜索列表，包含分类筛选树、价格区间筛选与排序组件。

第二步：用户鉴权与购物车下单

系统内置有全局登录拦截器。未登录状态下点击商品详情、购物车或用户中心时，拦截器会自动将请求重定向至前台登录页。使用预置的会员账号进行登录：

账号：13700002703
密码：123456

登录时需通过 4 位图形验证码校验。验证通过后即可进入商品详情页，自由选择商品参数并加入购物车。随后进入购物车结算页，填写收货地址即可创建支付订单。

第三步：后台综合配置管理

访问后台管理入口：

后台地址：http://127.0.0.1:28089/admin/login
默认账号：admin
默认密码：123456

登录后台后，左侧菜单提供了完整的电商运营功能体系：

• 轮播图管理：自主维护首页顶部滚动的 Banner 广告图与跳转链接
• 推荐配置：动态调整首页热销商品、新品上线以及为你推荐各个板块的展示位
• 商品分类管理：支持多级分类的层级新增与属性定义
• 商品管理：商品的图文详情编辑、库存设置与上下架控制
• 订单管理：查看买家订单详情，执行后台发货及状态流转操作

实测数据指标

以下指标全部来自当次实测真实运行记录，无估算与宣传修饰：

• 源码解压耗时：0.61 秒（共计 506 个文件，解压后体积 45.17MB）
• 数据库导入耗时：2.37 秒（9 张核心数据表，575 件商品数据，92 个分类）
• Windows Maven 打包耗时：12.55 秒（离线本地依赖库，生成 59,175,659 字节 fat jar）
• Windows 服务冷启动时间：3.35 秒（Tomcat 端口就绪，JVM 运行耗时 3.79 秒）
• 首页网络响应：HTTP 状态码 200，传输体积 42,398 字节，首次响应 0.196 秒
• Linux 侧构建与启动：构建耗时 126 秒，服务就绪启动 4.04 秒，二次响应 0.046 秒
• 双平台一致性：双平台 jar 均包含 715 个文件条目与 157 个 class 文件，核心逻辑与 HTML 渲染结构完全一致
• 页面健壮性：抽测 10 个核心路由，HTTP 请求 0 个 4xx/5xx 错误，控制台 0 个 JS 异常

界面长什么样

前台首页整合了顶部搜索、左侧分类悬浮菜单、核心轮播图以及下方的热销商品瀑布流，各模块商品图片与标题价格展示清晰直观。

商品搜索页支持关键字实时过滤与多级类目快速检索，左侧包含精准分类筛选面板，右侧为网格化商品卡片。

商品详情页面展示商品高清大图、价格属性、规格选项与图文详情说明，底部集成加入购物车与立即购买操作按钮。

购物车页面清晰列出已勾选商品的规格、单价、购买数量与小计金额，支持实时修改件数与一键结算。

订单结算确认页面集中展示收货人地址信息、商品清单汇总及应付总金额，点击即可生成待支付订单。

后台管理端提供独立的安全认证登录入口，验证码与防刷校验机制齐备，界面排版整洁。

一个真实的坑

在完整实测过程中，排查并解决了三个非常具体的问题，也是大家在初次运行该工程时最容易踩中卡住的环节：

第一处坑：商品图片上传目录绝对路径硬编码

源码中 Constants.FILE_UPLOAD_DIC 常量直接写死了 Windows 本地盘符路径 D:\upload\。这意味着如果使用者没有按照规定在 D 盘建立对应文件夹并平铺图片，或者解压时保留了外部 upload 压缩包目录层级，启动后前台所有商品图片请求均会因为找不到本地物理文件而报 404 错误。如果要移植至 Linux 服务器生产环境，必须修改该常量为 Linux 格式绝对路径重新打包，或者借助虚拟映射配置将请求转至实体存储目录。

第二处坑：测试库中两条初始轮播图外链失效

在导入 schema.sql 初始化脚本后，数据库中 tb_newbee_mall_carousel 轮播图表预置的两条广告记录指向早期外部对象存储地址。由于年代久远，当前访问该外部地址直接返回 HTTP 403 权限拒绝，导致前台首页顶部轮播图出现两张裂图。解决方法非常简单：登录后台管理系统的轮播图配置板块，或者直接在数据库中将这两条记录的图片地址修改为项目静态资源自带的本地 Banner 图，保存后首页轮播恢复如初。

第三处坑：前台图形验证码校验的长度拦截

系统前台会员登录与注册均启用了图形验证码。而在部分前端校验脚本函数中，对验证码字符长度的逻辑判断较为苛刻，若验证码长度超出 4 位会直接在前端被逻辑拦截阻止提交。输入验证码时需严格核对 4 位字符，切勿误输入多余空格或字符。

生产上线与部署建议

• 数据连接配置外置化：不要将生产环境数据库账号密码硬编码在 application.properties 中，推荐在启动命令行中使用参数覆盖注入，保证凭据安全。
• 动静分离分流访问压力：前台商品图片存放在本地磁盘中，推荐在生产架构前置 Nginx 反向代理，将 /goods-img/** 路由直接配置为本地静态资源映射，规避由 Java 应用服务承载大并发静态图片 I/O 带来的性能损耗。
• 敏感数据与口令清理：内置的管理员账号与会员账号密码在数据库中均采用预置的默认密码哈希，正式发布上线前务必登入后台及数据库，将管理员密码修改为高强度密码，并清空无关的测试订单数据。
• 进程守护与日常巡检：生产服务器建议配置 Systemd 守护进程或通过 Docker 容器化打包运行，配置好 OOM 自动拉起与垃圾回收日志归档，确保服务长久在线。

这几类人适合，这几类不适合

适合选用 NewBeeMall 的场景：

• 需要快速交付一套完整电商商城原型，不想在微服务治理和中间件部署上浪费时间的研发团队
• 偏好纯 Java 传统单体架构、希望前后端一体化打包交付的中小型企业
• 希望拥有一套结构规范、带真实测试数据的 Spring Boot 电商教学与二次开发底座的技术爱好者

不适合选用 NewBeeMall 的场景：

• 业务重心完全在手机端自适应网页的用户：前台前端属于典型的 PC 网页设计，采用固定宽度栅格布局，未做移动端响应式流式适配
• 面对高并发秒杀、需要分布式事务、多级缓存以及海量微服务拆分的大型电商平台业务
• 没有任何技术背景、期望通过浏览器点选安装向导一键建站的纯非技术站长

常见问题

源码获取

建议先转存到个人夸克网盘后再进行下载，避免因网络波动或分享链接变动导致资源中断。解压后可直接运行预编译 fat jar 快速体验完整功能，亦可直接导入 IDE 进行二次开发与业务定制。