SpringBoot超市管理系统：可调试、可部署的完整实战项目

简介：这是一套基于Spring Boot开发的超市信息管理系统完整源码资源，面向Java初学者与Web全栈学习者，解决中小型商超场景下的商品采购、销售、库存盘点及财务分析等核心业务管理需求。资源包大小为7.92MB，为RAR压缩格式，包含可直接运行的后端工程、配套数据库脚本及基础配置文件，支持远程调试与本地部署，结构清晰、注释完整，便于理解MVC分层设计与RESTful接口实践。已有918人学习下载，适合用于课程设计、毕业设计或Spring Boot实战能力提升。读者可获得完整可运行系统（含登录、商品录入、库存管理、销售模块等核心功能）、MySQL建表语句与初始化数据、前后端交互逻辑说明，以及典型购销存状态实时跟踪的技术实现思路，是掌握企业级Java Web项目开发流程的优质入门级参考范例。

1. 基于 SpringBoot 的超市信息管理系统：不是 Demo，是能进真实调试环境的可运行闭环系统

你有没有试过下载一个标着“SpringBoot 超市管理系统”的资源，解压后发现只有pom.xml和几个空包？或者启动报ClassNotFoundException，数据库脚本执行失败，连登录页都刷不出来？这个资源不是那种“教学演示型”项目——它自带完整 MySQL 数据库初始化脚本、已配置好 JPA/Hibernate 映射关系、Controller 层返回标准 REST 结构、前端页面（Thymeleaf）与后端逻辑严丝合缝，更重要的是，它预留了远程调试端口（默认 5005），支持在 IDEA 或 VS Code 中 attach 进程断点追踪库存扣减、会员积分计算等关键路径。它面向的是正在做课程设计、毕业设计或需要快速验证业务逻辑的 Java 后端初学者和中级开发者：不需要你从零搭框架，但保留了所有可修改、可扩展、可 debug 的原始结构。如果你正卡在“写完 Controller 不知道怎么连数据库”“改了 service 层但前端没反应”“日志里全是NullPointerException却找不到源头”，那这个系统就是为你准备的——它不炫技，但每一步都经得起打断点、查 SQL、看事务传播。

2. 项目结构与技术栈解析：为什么选 SpringBoot + Thymeleaf + MySQL 而不是其他组合？

这个系统不是为“秀技术栈”而堆砌组件，而是基于真实中小型超市管理场景下的开发效率、维护成本和部署确定性做出的务实选择。下面拆解每一层的技术选型依据，并说明它们如何协同工作。

2.1 后端核心：SpringBoot 2.7.x（非 3.x）+ Spring Data JPA

项目采用 SpringBoot 2.7.18（LTS 版本），而非更新的 3.x 系列，原因很实际：

• 大量高校教材、实训平台、老旧服务器仍基于 JDK 8/11，而 SpringBoot 3.x 强制要求 JDK 17+，会直接导致UnsupportedClassVersionError；
• 2.7.x 对spring-boot-starter-data-jpa的封装足够成熟，@Transactional在OrderService中控制库存扣减与订单生成的原子性时，异常回滚行为稳定可预测；
• application.yml中已预置多环境配置（dev,prod），dev模式下开启 HikariCP 连接池监控和 SQL 日志打印（logging.level.org.hibernate.SQL=DEBUG），方便你一眼看到“到底执行了哪条 UPDATE”。

提示：不要手动升级到 SpringBoot 3.x。若强行升级，需同步替换 Jakarta EE 命名空间（如javax.persistence.*→jakarta.persistence.*），且spring-boot-starter-thymeleaf的方言语法有兼容性断裂，会导致所有.html页面渲染失败。

2.2 数据持久层：MySQL 5.7+ + Flyway 初始化 + 实体类双向关联

数据库使用 MySQL 5.7 或 8.0（推荐 5.7，避免 8.0 默认 strict mode 导致INSERT INTO goods VALUES (...)因缺字段报错）。项目未用schema.sql粗暴建表，而是采用Flyway进行版本化迁移：

src/main/resources/db/migration/V1__init_schema.sql src/main/resources/db/migration/V2__insert_sample_data.sql

这样做的好处是：你本地改了V1__init_schema.sql，下次 clean 启动时 Flyway 会自动检测 checksum 变更并报错提醒，避免“改了建表语句但忘了执行”这种低级翻车。实体类之间采用标准 JPA 关系映射：

• Member↔Order：一对多（@OneToMany(mappedBy = "member")）
• Order↔OrderItem：一对多（@OneToMany(cascade = CascadeType.ALL)）
• Goods↔OrderItem：多对一（@ManyToOne(fetch = FetchType.LAZY)）

注意fetch = FetchType.LAZY是关键——它防止查询一个订单时，意外触发 N+1 查询把全库商品信息都捞出来。你在OrderController.list()中调用orderService.findAll()，日志里只会看到 1 条SELECT * FROM orders，而不是几十条SELECT * FROM goods WHERE id = ?。

2.3 前端交互：Thymeleaf 模板引擎 + 原生 HTML/CSS/JS

没有引入 Vue/React，因为这不是 WebApp 项目，而是典型的内部管理后台。Thymeleaf 的优势在于：

• 模板文件（.html）可直接双击浏览器打开，查看静态结构；
• 服务端渲染后，<span th:text="${member.name}">张三</span>在浏览器源码中就是纯文本，无 JS bundle 加载延迟；
• 表单提交走标准POST /order/save，后端@PostMapping方法接收@ModelAttribute Order order，参数绑定失败时自动跳转回/order/add?error=xxx，错误提示直出，不依赖前端校验。

所有页面位于src/main/resources/templates/下，CSS/JS 放在src/main/resources/static/，符合 SpringBoot 静态资源默认规则。你改一行 CSS，刷新即生效，无需 webpack 构建。

2.4 远程调试支持：内置 JVM 参数与 IDE 配置要点

项目pom.xml中<plugin>已声明spring-boot-maven-plugin并启用jvmArguments：

<plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <jvmArguments>-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005</jvmArguments> </configuration> </plugin>

这意味着：

• 打包后运行java -jar supermarket-system.jar，JVM 会监听0.0.0.0:5005；
• 你在公司内网另一台电脑上，用 IDEA 的Run → Attach to Process...输入 IP+5005，即可连接并打断点；
• suspend=n是重点：进程启动不阻塞，避免“卡在调试等待”导致超市收银机超时断连这类玄学问题。

3. 快速启动四步法：从解压到登录后台，全程不超过 5 分钟

别被“完整系统”吓住。只要你的机器装了 JDK 8+、MySQL、Maven，就能按以下步骤跑通。我把它拆成原子操作，每步失败都有明确排查点。

3.1 步骤一：初始化 MySQL 数据库与用户权限

先确保 MySQL 服务已启动（Windows 下服务名为MySQL80，Linux 下sudo systemctl status mysql）。然后执行：

-- 1. 创建数据库（字符集必须为 utf8mb4，否则中文商品名存成 ??） CREATE DATABASE supermarket DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 创建专用用户（不要用 root 连接应用！） CREATE USER 'sm_user'@'localhost' IDENTIFIED BY 'SmPass123!'; GRANT ALL PRIVILEGES ON supermarket.* TO 'sm_user'@'localhost'; FLUSH PRIVILEGES;

参数说明：utf8mb4支持 emoji 和四字节中文（如某些生僻姓氏），sm_user是应用配置中spring.datasource.username的值，密码SmPass123!需与application-dev.yml中保持一致。若你改了密码，必须同步改配置文件，否则启动时报Access denied for user。

3.2 步骤二：配置 application-dev.yml 并激活 profile

打开src/main/resources/application-dev.yml，确认以下三项已填：

spring: datasource: url: jdbc:mysql://localhost:3306/supermarket?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: sm_user password: SmPass123! flyway: enabled: true locations: classpath:db/migration

• url中serverTimezone=Asia/Shanghai必须存在，否则Order.createTime字段存入数据库的时间比实际快 8 小时；
• allowPublicKeyRetrieval=true是 MySQL 8.0+ 连接必需参数，漏写则报Public Key Retrieval is not allowed；
• flyway.enabled: true确保首次启动时自动执行 V1/V2 脚本建表插数据。

然后通过以下任一方式激活devprofile：

• 启动命令加参数：mvn spring-boot:run -Dspring.profiles.active=dev
• 或在application.yml顶层添加：spring.profiles.active: dev

3.3 步骤三：编译并启动（命令行 or IDE）

命令行方式（推荐验证环境是否干净）：

# 清理旧构建 mvn clean # 编译并启动（跳过测试加快速度） mvn compile spring-boot:run -DskipTests -Dspring.profiles.active=dev

看到控制台输出Started SupermarketApplication in X.XXX seconds且末尾有Tomcat started on port(s): 8080 (http)，即成功。

IDEA 方式（便于后续 debug）：

• 右键项目 →Run 'SupermarketApplication'；
• 若报Cannot resolve symbol 'SpringBootApplication'，右键pom.xml→Maven → Reload project；
• 启动后访问http://localhost:8080/login，输入默认账号admin / 123456即可进入后台。

3.4 步骤四：验证核心链路——下一笔测试订单

登录后依次点击：

1. 【商品管理】→ 【新增商品】：填名称“农夫山泉 550ml”，单价“2.0”，库存“100”，提交；
2. 【会员管理】→ 【新增会员】：填姓名“李四”，手机号“13800138000”，提交；
3. 【订单管理】→ 【新建订单】：选择会员“李四”，添加商品“农夫山泉”，数量“5”，提交；

此时观察控制台日志：

• 应出现Hibernate: update goods set stock=? where id=?（库存减 5）
• 应出现Hibernate: insert into orders (...) values (...)（新订单入库）
• 应出现Hibernate: insert into order_item (...) values (...)（订单明细入库）

如果这三行 SQL 都有，且页面跳转到订单列表页显示新订单，说明整个业务链路（Controller → Service → Repository → DB）完全打通。

4. 避坑指南：五个血泪经验换来的高频报错与根治方案

这个系统虽标“完美运行”，但实际部署时 80% 的失败源于环境差异或配置疏忽。以下是我在某高校实训课带学生实操时，记录的真实踩坑案例，按“现象 → 原因 → 解决”结构整理，每一条都对应可复现的错误现场。

4.1 现象：启动时报java.lang.ClassNotFoundException: javax.servlet.Filter

原因：JDK 版本高于 11 且使用了 SpringBoot 2.7.x，但 Maven 依赖中spring-boot-starter-web未排除tomcat-embed-jasper的传递依赖，导致 Servlet API 冲突。
解决：在pom.xml的spring-boot-starter-web依赖中显式排除：

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> </exclusion> </exclusions> </dependency>

4.2 现象：登录页打开空白，浏览器 F12 查看 Network，/login返回 401 或 404

原因：SecurityConfig.java中配置了http.authorizeHttpRequests()，但antMatchers("/login", "/css/**", "/js/**").permitAll()的路径模式写成了"/login/**"（多了一个/**），导致静态资源被拦截。
解决：检查SecurityConfig类，将antMatchers("/login/**")改为antMatchers("/login", "/css/**", "/js/**", "/images/**")，确保登录页所需资源全部放行。

4.3 现象：新增商品后，列表页显示“null”而非商品名，数据库中name字段为 NULL

原因：GoodsController.save()方法中用了@RequestBody Goods goods，但前端表单是application/x-www-form-urlencoded提交，Spring 无法自动绑定。
解决：将 Controller 方法改为接收@ModelAttribute Goods goods，并确保 Thymeleaf 表单th:object="${goods}"与字段名严格匹配（如th:field="*{name}"）。

4.4 现象：远程调试连接失败，IDEA 提示Connection refused

原因：pom.xml中jvmArguments的address=*:5005在 Windows 下可能被防火墙拦截，或 Linux 下netstat -an | grep 5005显示LISTEN但状态为:::5005（IPv6），而 IDEA 默认连 IPv4。
解决：将address=*:5005改为address=localhost:5005，并确保启动命令中-Dspring.profiles.active=dev生效（dev profile 才加载该 JVM 参数）。

4.5 现象：修改商品库存后，订单提交时库存未扣减，或出现负数

原因：OrderService.createOrder()中库存扣减逻辑未加数据库行锁，高并发下发生超卖。原代码为：

Goods goods = goodsRepository.findById(orderItem.getGoodsId()).get(); goods.setStock(goods.getStock() - orderItem.getQuantity()); goodsRepository.save(goods); // ❌ 无事务隔离，读-改-写非原子

解决：改用@Transactional+SELECT ... FOR UPDATE：

@Modifying @Query("UPDATE goods SET stock = stock - :quantity WHERE id = :goodsId AND stock >= :quantity") int reduceStock(@Param("goodsId") Long goodsId, @Param("quantity") Integer quantity);

并在调用前检查返回值是否为 1，否则抛InsufficientStockException。

5. 进阶实战：给库存扣减加分布式锁，防止集群部署下的超卖

当系统从单机部署升级为多实例（如 Nginx 负载均衡两台服务器），上面的UPDATE ... WHERE stock >= quantity仍可能失效——因为两个实例同时读到stock=10，各自执行SET stock = 10 - 5，最终库存变成 5 而非 0。这时必须引入分布式锁。本系统预留了RedisTemplateBean，我们用最轻量的 Redis SETNX 实现。

5.1 准备工作：启用 Redis 并配置连接

先安装 Redis（Docker 最快）：

docker run -d --name redis-supermarket -p 6379:6379 -d redis:7-alpine

然后在application-dev.yml中添加：

spring: redis: host: localhost port: 6379 database: 0

5.2 编写库存扣减锁方法（加在 GoodsService 中）

@Service public class GoodsService { @Autowired private RedisTemplate<String, Object> redisTemplate; @Autowired private GoodsRepository goodsRepository; public boolean tryLockAndReduceStock(Long goodsId, Integer quantity) { String lockKey = "lock:goods:" + goodsId; String lockValue = UUID.randomUUID().toString(); // 1. 尝试获取锁（SETNX + EXPIRE 合并为 SET 命令） Boolean locked = redisTemplate.opsForValue() .setIfAbsent(lockKey, lockValue, Duration.ofSeconds(10)); if (!locked) { return false; // 获取锁失败，直接返回 } try { // 2. 在锁内执行扣减（双重检查库存） Goods goods = goodsRepository.findById(goodsId) .orElseThrow(() -> new GoodsNotFoundException(goodsId)); if (goods.getStock() < quantity) { return false; } goods.setStock(goods.getStock() - quantity); goodsRepository.save(goods); return true; } finally { // 3. 安全释放锁（Lua 脚本保证原子性） String script = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end"; redisTemplate.execute(new DefaultRedisScript<>(script, Long.class), Collections.singletonList(lockKey), lockValue); } } }

逻辑说明：

• setIfAbsent(..., Duration.ofSeconds(10))是 Redis 的SET key value EX 10 NX，避免死锁；
• finally中的 Lua 脚本确保“只有加锁者才能删锁”，防止 A 实例锁过期后，B 实例误删 A 的锁；
• 整个方法返回boolean，调用方（OrderService）据此决定是重试还是提示“库存不足”。

5.3 在 OrderService 中集成锁调用

@Service @Transactional public class OrderService { @Autowired private GoodsService goodsService; public Order createOrder(Order order) { for (OrderItem item : order.getItems()) { // 关键：每次扣减前先尝试加锁 boolean success = goodsService.tryLockAndReduceStock(item.getGoodsId(), item.getQuantity()); if (!success) { throw new InsufficientStockException("商品ID " + item.getGoodsId() + " 库存不足"); } } // ... 后续保存订单逻辑 return orderRepository.save(order); } }

5.4 压测验证：用 Apache Bench 模拟并发下单

启动两个终端，分别执行：

# 终端1：持续下单（100次请求，10并发） ab -n 100 -c 10 'http://localhost:8080/order/create?goodsId=1&quantity=1' # 终端2：实时查库存 watch -n 1 'mysql -usm_user -pSmPass123! -e "SELECT stock FROM supermarket.goods WHERE id=1;"'

你会看到：库存从 100 严格递减到 0，不会出现负数或跳变。而如果注释掉tryLockAndReduceStock()，直接调用原扣减方法，ab压测后库存大概率是 -20 或 -50。

从那以后我每次做库存类功能，都强制走一遍「本地单测 → AB 压测 → Redis 锁集成 → 日志埋点验证」四步闭环。哪怕只是课程设计，也要让关键路径经得起并发推演——毕竟真实超市的收银系统，可不会因为你“只是作业”就宽容超卖。希望帮到你。

本文还有配套的精品资源，点击获取