简介这是一套面向高校计算机相关专业学生与Java Web初学者、课程设计开发者的企业仓库存储管理系统完整源码采用Spring BootJavaMavenMySQLMyBatis技术栈基于B/S结构使用IntelliJ IDEA开发可作为课程设计、毕业设计或Java Web综合练习的参考方案。压缩包共221个文件约6.95MB其中42个java源文件承载后端业务逻辑28个html与24个js、8个css构成前端页面与交互另有9个xml、1个sql建表脚本及properties配置、mvnw构建脚本等并包含gif、jpg、png等界面截图与图标资源便于快速理解项目结构与运行效果。系统覆盖客户、仓库、产品基本信息管理用户与权限管理入库、出库记录管理库存管理及系统日志查看等模块功能链路完整。目前已有568人学习下载适合需要一套可直接参考的仓库管理类项目源码、对照梳理分层设计与数据库表结构的学习者。1. 从一份能跑通的仓库管理系统源码说起它到底解决了什么问题很多同学做课程设计时最头疼的不是写代码而是找不到一个结构完整、能跑通、功能覆盖到位的参考项目。这份基于 Spring Boot Java Maven MySQL MyBatis 的企业仓库存储管理系统编号 100010160恰好就是为这个场景准备的。它采用 B/S 结构前端用 Layui 和 X-admin 做界面后端用 Spring Boot 整合 MyBatis 操作 MySQL开发工具是 IntelliJ IDEA。功能上覆盖了客户信息、仓库信息、产品信息、用户权限、入库记录、出库记录、库存管理和系统日志八大模块每个模块都包含增删改查。如果你正在找一份 javaweb 项目完整案例 mysql 方向的参考或者想拿一个真实的企业级 web 开发骨架来练手这份源码值得拆开看。它适合课程设计、毕业设计也适合刚学完 SSM 想过渡到 Spring Boot 的开发者。2. 环境搭建与数据库初始化从零把项目跑起来2.1 开发环境选型与版本对齐拿到源码第一步不是急着点运行而是先把环境对齐。这份项目用的是 Spring Boot Maven 的组合Maven 的版本管理能力在这里体现得很明显——依赖不用手动下载 jar 包pom.xml 里声明好坐标mvnw.cmd 脚本会自动拉取。JDK 建议用 1.8 或 11MySQL 用 5.7 或 8.0 都可以但要注意驱动包版本和连接串的差异。IDEA 导入项目时选择「Import Project from External Model」→ Maven让 IDEA 自动识别 pom 文件并下载依赖。如果依赖下载慢可以在 Maven 的 settings.xml 里配置国内镜像源这是常见做法能省不少等待时间。前端资源方面项目里包含了 layui.css、layer.css、xadmin.css、layui.mobile.css、laydate.css、login.css、code.css、font.css 以及 iconfont.eot 等文件说明界面层用的是 Layui 框架配合 X-admin 后台模板。这些静态资源不需要额外构建放在 resources/static 目录下即可被 Spring Boot 自动映射。2.2 数据库建库建表与连接配置数据库是整个系统的地基。先在 MySQL 里创建一个库字符集用 utf8mb4排序规则用 utf8mb4_general_ci。然后执行项目提供的 SQL 脚本建表。常见做法是把 SQL 文件放在 src/main/resources 下或者单独放在项目根目录的 sql 文件夹里。-- 创建数据库字符集用 utf8mb4 避免中文乱码 CREATE DATABASE warehouse_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 切换到该数据库 USE warehouse_db; -- 用户表存储系统登录账号和权限信息 CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role VARCHAR(20) DEFAULT user, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 仓库信息表记录仓库的基本属性 CREATE TABLE warehouse ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, address VARCHAR(200), capacity INT, manager VARCHAR(50) );建表时要注意字段类型和长度比如密码字段至少给 100 长度因为后面如果加加密存储BCrypt 哈希值会比较长。角色字段用 VARCHAR 而不是 ENUM方便后续扩展权限。连接配置在 application.yml 或 application.properties 里。如果用 yml 格式spring: datasource: url: jdbc:mysql://localhost:3306/warehouse_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.warehouse.entity这里有几个参数值得注意useUnicodetruecharacterEncodingutf8是防止中文乱码的标配serverTimezoneAsia/Shanghai在 MySQL 8.0 以上必须加否则会报时区错误。driver-class-name 在 MySQL 8.0 里用com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver写错了启动直接失败。2.3 启动项目与验证接口连通性配置完成后在 IDEA 里找到主启动类右键 Run。控制台看到 Tomcat started on port(s): 8080 就说明启动成功了。打开浏览器访问http://localhost:8080应该能看到登录页。如果页面样式丢失检查静态资源路径是否被拦截器拦截了——Spring Boot 默认会放行 static 目录下的资源但如果自己写了 WebMvcConfigurer要确保没有把/css/**、/js/**这些路径给挡掉。登录后先测试客户管理模块点新增填几条数据看能不能正常写入数据库。这一步验证的是 Controller → Service → Mapper → MySQL 这条链路是否通畅。如果新增报 500先看控制台异常栈最常见的是 Mapper XML 里的 namespace 写错或者实体类字段和数据库列名没对上。MyBatis 默认开启驼峰映射的话user_name会自动映射到userName但前提是map-underscore-to-camel-case设为 true。3. 核心模块拆解增删改查背后的代码逻辑与参数设计3.1 客户与仓库管理模块的实现套路客户管理和仓库管理这两个模块的结构几乎一样都是标准的 CRUD。以客户管理为例Controller 层接收前端传来的 JSON 或表单参数调用 Service 层Service 再调 Mapper 接口Mapper 通过 XML 里的 SQL 语句操作数据库。这种分层的好处是职责清晰改 SQL 不用动 Java 代码改业务逻辑不用动 SQL。// CustomerController.java 片段 RestController RequestMapping(/customer) public class CustomerController { Autowired private CustomerService customerService; // 分页查询客户列表page 和 limit 由 Layui 的 table 组件传入 GetMapping(/list) public MapString, Object list(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int limit, String keyword) { MapString, Object result new HashMap(); ListCustomer customers customerService.findByPage(page, limit, keyword); long count customerService.count(keyword); result.put(code, 0); result.put(msg, ); result.put(count, count); result.put(data, customers); return result; } // 新增客户接收前端表单序列化后的 JSON PostMapping(/add) public MapString, Object add(RequestBody Customer customer) { MapString, Object result new HashMap(); try { customerService.insert(customer); result.put(success, true); result.put(msg, 添加成功); } catch (Exception e) { result.put(success, false); result.put(msg, 添加失败 e.getMessage()); } return result; } }这段代码里RestController让返回值自动序列化成 JSON省去了ResponseBody的重复标注。分页查询返回的 Map 结构是 Layui table 组件要求的固定格式code 为 0 表示成功count 是总记录数data 是当前页数据。如果 code 不是 0前端表格会显示不出来。RequestBody用于接收 JSON 格式的请求体如果前端用的是表单提交就得换成RequestParam逐个接收或者用ModelAttribute自动绑定。Mapper XML 里写 SQL 时模糊查询要用CONCAT(%, #{keyword}, %)不要用${}拼接否则会有 SQL 注入风险。这是血泪经验很多课程设计项目在这块翻车。3.2 入库出库与库存联动的事务处理入库和出库是仓库系统的核心业务它们和库存表之间存在联动关系。入库时库存要增加出库时库存要减少这两个操作必须在同一个事务里完成否则会出现「入库记录写了但库存没加」这种数据不一致的情况。// StockService.java 片段 Service public class StockService { Autowired private StockMapper stockMapper; Autowired private InboundMapper inboundMapper; // 入库操作插入入库记录 更新库存Transactional 保证原子性 Transactional(rollbackFor Exception.class) public void inbound(InboundRecord record) { // 1. 插入入库记录 inboundMapper.insert(record); // 2. 查询该产品在对应仓库的现有库存 Stock stock stockMapper.findByProductAndWarehouse( record.getProductId(), record.getWarehouseId()); if (stock null) { // 3. 如果库存记录不存在新建一条 stock new Stock(); stock.setProductId(record.getProductId()); stock.setWarehouseId(record.getWarehouseId()); stock.setQuantity(record.getQuantity()); stockMapper.insert(stock); } else { // 4. 如果已存在累加数量 stock.setQuantity(stock.getQuantity() record.getQuantity()); stockMapper.updateQuantity(stock); } } }Transactional(rollbackFor Exception.class)这个注解是关键它保证方法内任何一步抛异常前面的数据库操作都会回滚。默认情况下Spring 只对 RuntimeException 回滚如果抛出的是 checked exception不加rollbackFor就不会回滚这是很多人踩过的坑。出库逻辑类似但要在更新前判断库存是否充足不足时抛出自定义异常让事务回滚并给前端返回提示。库存表的设计上常见做法是用product_id warehouse_id做联合唯一索引防止同一个产品在同一个仓库出现多条库存记录。查询库存时用SELECT ... FOR UPDATE加行锁能避免并发入库时的超卖问题不过课程设计级别的项目并发量不大不加也能跑。3.3 用户权限与系统日志的落地方式用户管理模块包含添加用户、修改权限、删除用户。权限控制通常用一个 role 字段区分管理员和普通用户登录时根据角色跳转到不同页面或者在拦截器里判断当前用户是否有权访问某个 URL。系统日志模块则是记录用户的关键操作比如谁在什么时间删除了哪条记录。// LogAspect.java 片段用 AOP 自动记录操作日志 Aspect Component public class LogAspect { Autowired private SysLogMapper sysLogMapper; // 拦截所有 Controller 的写操作 AfterReturning(execution(* com.warehouse.controller.*.add*(..)) || execution(* com.warehouse.controller.*.update*(..)) || execution(* com.warehouse.controller.*.delete*(..))) public void recordLog(JoinPoint joinPoint) { SysLog log new SysLog(); log.setMethod(joinPoint.getSignature().getName()); log.setParams(Arrays.toString(joinPoint.getArgs())); log.setCreateTime(new Date()); // 从 Session 或 ThreadLocal 里取当前登录用户 log.setUsername(UserContext.getCurrentUsername()); sysLogMapper.insert(log); } }用 AOP 做日志的好处是不用在每个方法里手动写插入日志的代码切点表达式匹配 add、update、delete 开头的方法自动记录方法名和参数。UserContext可以用 ThreadLocal 实现在拦截器里登录成功后把用户信息存进去请求结束时清理掉。日志表的数据量会随时间增长建议加一个定时任务定期清理三个月前的日志或者按月份分表。4. 避坑与排查跑这个项目时最容易翻车的几个地方4.1 启动报错「Failed to configure a DataSource」现象是项目一启动就抛异常提示找不到数据源或者 URL 格式不对。原因通常是 application.yml 里数据库连接配置写错了比如 url 少写了jdbc:前缀或者 username/password 填的是占位符但没有实际替换。解决方法是逐项核对连接串确保格式是jdbc:mysql://主机:端口/库名?参数密码不要带特殊字符如果有特殊字符要用引号包起来。另外检查 pom.xml 里是否引入了mysql-connector-java依赖没有这个依赖 Spring Boot 无法识别 MySQL 驱动。4.2 页面能打开但表格数据不显示前端 Layui table 发请求后返回了数据但表格是空的。原因多半是返回的 JSON 结构不符合 Layui 的要求。Layui table 默认要求code为 0、count为总条数、data为数组。如果后端返回的是{total: 100, rows: [...]}这种格式前端就解析不了。解决办法是在 Controller 里手动组装成 Layui 要求的格式或者在前端配置parseData回调函数做转换。还有一种情况是返回的字段名和表格列的field属性对不上比如后端返回userName前端写的username大小写不一致也会导致空白。4.3 中文乱码从数据库一路乱到页面现象是新增一条中文记录数据库里存的是问号或者页面显示乱码。原因可能出在三个环节数据库字符集不是 utf8mb4、连接串没加 characterEncodingutf8、Tomcat 的 URI 编码没配。解决方法是建库时指定CHARACTER SET utf8mb4连接串加上useUnicodetruecharacterEncodingutf8然后在 application.yml 里加server.servlet.encoding.charsetutf-8和server.servlet.encoding.forcetrue。三个地方都对齐了乱码问题基本就消失了。4.4 删除操作报外键约束错误删除客户或产品时如果该客户下还有入库记录数据库会抛外键约束异常。原因是表设计时加了 FOREIGN KEY 约束但没有配置级联删除。解决方式有两种一种是在删除前先检查关联记录有则提示用户不能删另一种是把外键约束改成ON DELETE CASCADE删主表记录时自动删子表。课程设计里更推荐第一种因为级联删除风险太大容易误删数据。如果确实要删先在 Service 层做关联查询确认没有子记录再执行删除。4.5 Mapper 接口和 XML 文件不匹配启动时报Invalid bound statement (not found)意思是 Mapper 接口里的方法在 XML 里找不到对应的 SQL。原因通常是 XML 的 namespace 写错了或者方法名和 XML 里的 id 不一致或者 mapper-locations 配置的路径没覆盖到 XML 文件。解决方法是检查三处namespace 是否等于 Mapper 接口的全限定名、每个方法的 id 是否和接口方法名完全一致、application.yml 里的mapper-locations是否指向了正确的目录。IDEA 里可以在 Mapper 接口方法上按 CtrlB 跳转到 XML跳不过去就说明没匹配上。5. 进阶技巧把课程设计改造成能写进简历的项目5.1 用 MyBatis-Plus 替换原生 MyBatis 减少样板代码原生 MyBatis 每个实体都要写一套 XML字段多了很繁琐。MyBatis-Plus 提供了 BaseMapper 和 IService单表增删改查不用写 SQL直接调方法就行。改造方式是引入mybatis-plus-boot-starter依赖把 Mapper 接口改成继承BaseMapperEntityService 实现类继承ServiceImplMapper, Entity。分页查询用Page对象不用再手写 limit 语句。这样改完代码量能减少一半以上面试时聊起来也比纯 CRUD 有亮点。// 改造后的 CustomerService继承 ServiceImpl 后直接拥有 save、removeById、page 等方法 Service public class CustomerService extends ServiceImplCustomerMapper, Customer { // 自定义分页查询MyBatis-Plus 的 Page 对象自动处理 limit public PageCustomer findByPage(int page, int size, String keyword) { PageCustomer p new Page(page, size); QueryWrapperCustomer wrapper new QueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(name, keyword).or().like(phone, keyword); } return this.page(p, wrapper); } }QueryWrapper的like方法会自动拼成LIKE %keyword%不用手写 SQL。or()表示两个条件之间是 OR 关系不加的话默认是 AND。分页插件需要在配置类里注册MybatisPlusInterceptor并添加PaginationInnerInterceptor否则 page 方法不会真正分页而是查全量再内存分页数据量大时性能很差。5.2 加一层 Redis 缓存把库存查询压下去库存查询是高频操作每次进出库页面都查数据库会给 MySQL 带来压力。引入 Redis 做缓存把库存数据以stock:productId:warehouseId为 key 存起来查询时先走 Redis没有再查数据库并回写缓存。更新库存时同步删除缓存避免脏数据。Spring Boot 整合 Redis 只需要加spring-boot-starter-data-redis依赖配置 host 和 port然后用StringRedisTemplate或RedisTemplate操作。// StockService 里加缓存逻辑 Autowired private StringRedisTemplate redisTemplate; public Stock getStock(Integer productId, Integer warehouseId) { String key stock: productId : warehouseId; String cached redisTemplate.opsForValue().get(key); if (cached ! null) { return JSON.parseObject(cached, Stock.class); } Stock stock stockMapper.findByProductAndWarehouse(productId, warehouseId); if (stock ! null) { redisTemplate.opsForValue().set(key, JSON.toJSONString(stock), 10, TimeUnit.MINUTES); } return stock; }缓存过期时间设 10 分钟是权衡一致性和性能的结果。更新库存时用redisTemplate.delete(key)删缓存下次查询会重新加载。注意缓存穿透问题——如果查一个不存在的库存每次都打到数据库可以在缓存里存一个空对象并设短过期时间。这套改造做完项目就从「能跑」变成了「能扛」面试时聊缓存策略也有东西可说。5.3 用日志和监控验证系统稳定性项目跑起来之后怎么确认它稳定我一般会做三件事。第一看系统日志表里有没有异常记录特别是删除和修改操作确认每次操作都有迹可循。第二用 Postman 或 curl 对核心接口做并发测试比如同时发 50 个入库请求看库存数量对不对得上。第三在 application.yml 里把 MyBatis 的 SQL 日志打开观察实际执行的 SQL 和参数确认没有全表扫描。# 开启 MyBatis SQL 日志开发阶段用 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl打开之后控制台会打印每条 SQL 和参数能直观看到有没有走索引、有没有多余的查询。上线前记得关掉否则日志量太大。从那以后我每次交付一个项目都会先跑一遍并发测试再打开 SQL 日志扫一眼确认没有慢查询才敢说「能用了」。希望这份拆解能帮你少走弯路顺利把项目跑起来、改下去。本文还有配套的精品资源点击获取 
长河君 · 2026/10/8 20:25:12 · 阅读 1.2k Spring Boot仓库管理系统源码解析：从环境搭建到进阶优化
简介这是一套面向高校计算机相关专业学生与Java Web初学者、课程设计开发者的企业仓库存储管理系统完整源码采用Spring BootJavaMavenMySQLMyBatis技术栈基于B/S结构使用IntelliJ IDEA开发可作为课程设计、毕业设计或Java Web综合练习的参考方案。压缩包共221个文件约6.95MB其中42个java源文件承载后端业务逻辑28个html与24个js、8个css构成前端页面与交互另有9个xml、1个sql建表脚本及properties配置、mvnw构建脚本等并包含gif、jpg、png等界面截图与图标资源便于快速理解项目结构与运行效果。系统覆盖客户、仓库、产品基本信息管理用户与权限管理入库、出库记录管理库存管理及系统日志查看等模块功能链路完整。目前已有568人学习下载适合需要一套可直接参考的仓库管理类项目源码、对照梳理分层设计与数据库表结构的学习者。1. 从一份能跑通的仓库管理系统源码说起它到底解决了什么问题很多同学做课程设计时最头疼的不是写代码而是找不到一个结构完整、能跑通、功能覆盖到位的参考项目。这份基于 Spring Boot Java Maven MySQL MyBatis 的企业仓库存储管理系统编号 100010160恰好就是为这个场景准备的。它采用 B/S 结构前端用 Layui 和 X-admin 做界面后端用 Spring Boot 整合 MyBatis 操作 MySQL开发工具是 IntelliJ IDEA。功能上覆盖了客户信息、仓库信息、产品信息、用户权限、入库记录、出库记录、库存管理和系统日志八大模块每个模块都包含增删改查。如果你正在找一份 javaweb 项目完整案例 mysql 方向的参考或者想拿一个真实的企业级 web 开发骨架来练手这份源码值得拆开看。它适合课程设计、毕业设计也适合刚学完 SSM 想过渡到 Spring Boot 的开发者。2. 环境搭建与数据库初始化从零把项目跑起来2.1 开发环境选型与版本对齐拿到源码第一步不是急着点运行而是先把环境对齐。这份项目用的是 Spring Boot Maven 的组合Maven 的版本管理能力在这里体现得很明显——依赖不用手动下载 jar 包pom.xml 里声明好坐标mvnw.cmd 脚本会自动拉取。JDK 建议用 1.8 或 11MySQL 用 5.7 或 8.0 都可以但要注意驱动包版本和连接串的差异。IDEA 导入项目时选择「Import Project from External Model」→ Maven让 IDEA 自动识别 pom 文件并下载依赖。如果依赖下载慢可以在 Maven 的 settings.xml 里配置国内镜像源这是常见做法能省不少等待时间。前端资源方面项目里包含了 layui.css、layer.css、xadmin.css、layui.mobile.css、laydate.css、login.css、code.css、font.css 以及 iconfont.eot 等文件说明界面层用的是 Layui 框架配合 X-admin 后台模板。这些静态资源不需要额外构建放在 resources/static 目录下即可被 Spring Boot 自动映射。2.2 数据库建库建表与连接配置数据库是整个系统的地基。先在 MySQL 里创建一个库字符集用 utf8mb4排序规则用 utf8mb4_general_ci。然后执行项目提供的 SQL 脚本建表。常见做法是把 SQL 文件放在 src/main/resources 下或者单独放在项目根目录的 sql 文件夹里。-- 创建数据库字符集用 utf8mb4 避免中文乱码 CREATE DATABASE warehouse_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 切换到该数据库 USE warehouse_db; -- 用户表存储系统登录账号和权限信息 CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role VARCHAR(20) DEFAULT user, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 仓库信息表记录仓库的基本属性 CREATE TABLE warehouse ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, address VARCHAR(200), capacity INT, manager VARCHAR(50) );建表时要注意字段类型和长度比如密码字段至少给 100 长度因为后面如果加加密存储BCrypt 哈希值会比较长。角色字段用 VARCHAR 而不是 ENUM方便后续扩展权限。连接配置在 application.yml 或 application.properties 里。如果用 yml 格式spring: datasource: url: jdbc:mysql://localhost:3306/warehouse_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.warehouse.entity这里有几个参数值得注意useUnicodetruecharacterEncodingutf8是防止中文乱码的标配serverTimezoneAsia/Shanghai在 MySQL 8.0 以上必须加否则会报时区错误。driver-class-name 在 MySQL 8.0 里用com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver写错了启动直接失败。2.3 启动项目与验证接口连通性配置完成后在 IDEA 里找到主启动类右键 Run。控制台看到 Tomcat started on port(s): 8080 就说明启动成功了。打开浏览器访问http://localhost:8080应该能看到登录页。如果页面样式丢失检查静态资源路径是否被拦截器拦截了——Spring Boot 默认会放行 static 目录下的资源但如果自己写了 WebMvcConfigurer要确保没有把/css/**、/js/**这些路径给挡掉。登录后先测试客户管理模块点新增填几条数据看能不能正常写入数据库。这一步验证的是 Controller → Service → Mapper → MySQL 这条链路是否通畅。如果新增报 500先看控制台异常栈最常见的是 Mapper XML 里的 namespace 写错或者实体类字段和数据库列名没对上。MyBatis 默认开启驼峰映射的话user_name会自动映射到userName但前提是map-underscore-to-camel-case设为 true。3. 核心模块拆解增删改查背后的代码逻辑与参数设计3.1 客户与仓库管理模块的实现套路客户管理和仓库管理这两个模块的结构几乎一样都是标准的 CRUD。以客户管理为例Controller 层接收前端传来的 JSON 或表单参数调用 Service 层Service 再调 Mapper 接口Mapper 通过 XML 里的 SQL 语句操作数据库。这种分层的好处是职责清晰改 SQL 不用动 Java 代码改业务逻辑不用动 SQL。// CustomerController.java 片段 RestController RequestMapping(/customer) public class CustomerController { Autowired private CustomerService customerService; // 分页查询客户列表page 和 limit 由 Layui 的 table 组件传入 GetMapping(/list) public MapString, Object list(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int limit, String keyword) { MapString, Object result new HashMap(); ListCustomer customers customerService.findByPage(page, limit, keyword); long count customerService.count(keyword); result.put(code, 0); result.put(msg, ); result.put(count, count); result.put(data, customers); return result; } // 新增客户接收前端表单序列化后的 JSON PostMapping(/add) public MapString, Object add(RequestBody Customer customer) { MapString, Object result new HashMap(); try { customerService.insert(customer); result.put(success, true); result.put(msg, 添加成功); } catch (Exception e) { result.put(success, false); result.put(msg, 添加失败 e.getMessage()); } return result; } }这段代码里RestController让返回值自动序列化成 JSON省去了ResponseBody的重复标注。分页查询返回的 Map 结构是 Layui table 组件要求的固定格式code 为 0 表示成功count 是总记录数data 是当前页数据。如果 code 不是 0前端表格会显示不出来。RequestBody用于接收 JSON 格式的请求体如果前端用的是表单提交就得换成RequestParam逐个接收或者用ModelAttribute自动绑定。Mapper XML 里写 SQL 时模糊查询要用CONCAT(%, #{keyword}, %)不要用${}拼接否则会有 SQL 注入风险。这是血泪经验很多课程设计项目在这块翻车。3.2 入库出库与库存联动的事务处理入库和出库是仓库系统的核心业务它们和库存表之间存在联动关系。入库时库存要增加出库时库存要减少这两个操作必须在同一个事务里完成否则会出现「入库记录写了但库存没加」这种数据不一致的情况。// StockService.java 片段 Service public class StockService { Autowired private StockMapper stockMapper; Autowired private InboundMapper inboundMapper; // 入库操作插入入库记录 更新库存Transactional 保证原子性 Transactional(rollbackFor Exception.class) public void inbound(InboundRecord record) { // 1. 插入入库记录 inboundMapper.insert(record); // 2. 查询该产品在对应仓库的现有库存 Stock stock stockMapper.findByProductAndWarehouse( record.getProductId(), record.getWarehouseId()); if (stock null) { // 3. 如果库存记录不存在新建一条 stock new Stock(); stock.setProductId(record.getProductId()); stock.setWarehouseId(record.getWarehouseId()); stock.setQuantity(record.getQuantity()); stockMapper.insert(stock); } else { // 4. 如果已存在累加数量 stock.setQuantity(stock.getQuantity() record.getQuantity()); stockMapper.updateQuantity(stock); } } }Transactional(rollbackFor Exception.class)这个注解是关键它保证方法内任何一步抛异常前面的数据库操作都会回滚。默认情况下Spring 只对 RuntimeException 回滚如果抛出的是 checked exception不加rollbackFor就不会回滚这是很多人踩过的坑。出库逻辑类似但要在更新前判断库存是否充足不足时抛出自定义异常让事务回滚并给前端返回提示。库存表的设计上常见做法是用product_id warehouse_id做联合唯一索引防止同一个产品在同一个仓库出现多条库存记录。查询库存时用SELECT ... FOR UPDATE加行锁能避免并发入库时的超卖问题不过课程设计级别的项目并发量不大不加也能跑。3.3 用户权限与系统日志的落地方式用户管理模块包含添加用户、修改权限、删除用户。权限控制通常用一个 role 字段区分管理员和普通用户登录时根据角色跳转到不同页面或者在拦截器里判断当前用户是否有权访问某个 URL。系统日志模块则是记录用户的关键操作比如谁在什么时间删除了哪条记录。// LogAspect.java 片段用 AOP 自动记录操作日志 Aspect Component public class LogAspect { Autowired private SysLogMapper sysLogMapper; // 拦截所有 Controller 的写操作 AfterReturning(execution(* com.warehouse.controller.*.add*(..)) || execution(* com.warehouse.controller.*.update*(..)) || execution(* com.warehouse.controller.*.delete*(..))) public void recordLog(JoinPoint joinPoint) { SysLog log new SysLog(); log.setMethod(joinPoint.getSignature().getName()); log.setParams(Arrays.toString(joinPoint.getArgs())); log.setCreateTime(new Date()); // 从 Session 或 ThreadLocal 里取当前登录用户 log.setUsername(UserContext.getCurrentUsername()); sysLogMapper.insert(log); } }用 AOP 做日志的好处是不用在每个方法里手动写插入日志的代码切点表达式匹配 add、update、delete 开头的方法自动记录方法名和参数。UserContext可以用 ThreadLocal 实现在拦截器里登录成功后把用户信息存进去请求结束时清理掉。日志表的数据量会随时间增长建议加一个定时任务定期清理三个月前的日志或者按月份分表。4. 避坑与排查跑这个项目时最容易翻车的几个地方4.1 启动报错「Failed to configure a DataSource」现象是项目一启动就抛异常提示找不到数据源或者 URL 格式不对。原因通常是 application.yml 里数据库连接配置写错了比如 url 少写了jdbc:前缀或者 username/password 填的是占位符但没有实际替换。解决方法是逐项核对连接串确保格式是jdbc:mysql://主机:端口/库名?参数密码不要带特殊字符如果有特殊字符要用引号包起来。另外检查 pom.xml 里是否引入了mysql-connector-java依赖没有这个依赖 Spring Boot 无法识别 MySQL 驱动。4.2 页面能打开但表格数据不显示前端 Layui table 发请求后返回了数据但表格是空的。原因多半是返回的 JSON 结构不符合 Layui 的要求。Layui table 默认要求code为 0、count为总条数、data为数组。如果后端返回的是{total: 100, rows: [...]}这种格式前端就解析不了。解决办法是在 Controller 里手动组装成 Layui 要求的格式或者在前端配置parseData回调函数做转换。还有一种情况是返回的字段名和表格列的field属性对不上比如后端返回userName前端写的username大小写不一致也会导致空白。4.3 中文乱码从数据库一路乱到页面现象是新增一条中文记录数据库里存的是问号或者页面显示乱码。原因可能出在三个环节数据库字符集不是 utf8mb4、连接串没加 characterEncodingutf8、Tomcat 的 URI 编码没配。解决方法是建库时指定CHARACTER SET utf8mb4连接串加上useUnicodetruecharacterEncodingutf8然后在 application.yml 里加server.servlet.encoding.charsetutf-8和server.servlet.encoding.forcetrue。三个地方都对齐了乱码问题基本就消失了。4.4 删除操作报外键约束错误删除客户或产品时如果该客户下还有入库记录数据库会抛外键约束异常。原因是表设计时加了 FOREIGN KEY 约束但没有配置级联删除。解决方式有两种一种是在删除前先检查关联记录有则提示用户不能删另一种是把外键约束改成ON DELETE CASCADE删主表记录时自动删子表。课程设计里更推荐第一种因为级联删除风险太大容易误删数据。如果确实要删先在 Service 层做关联查询确认没有子记录再执行删除。4.5 Mapper 接口和 XML 文件不匹配启动时报Invalid bound statement (not found)意思是 Mapper 接口里的方法在 XML 里找不到对应的 SQL。原因通常是 XML 的 namespace 写错了或者方法名和 XML 里的 id 不一致或者 mapper-locations 配置的路径没覆盖到 XML 文件。解决方法是检查三处namespace 是否等于 Mapper 接口的全限定名、每个方法的 id 是否和接口方法名完全一致、application.yml 里的mapper-locations是否指向了正确的目录。IDEA 里可以在 Mapper 接口方法上按 CtrlB 跳转到 XML跳不过去就说明没匹配上。5. 进阶技巧把课程设计改造成能写进简历的项目5.1 用 MyBatis-Plus 替换原生 MyBatis 减少样板代码原生 MyBatis 每个实体都要写一套 XML字段多了很繁琐。MyBatis-Plus 提供了 BaseMapper 和 IService单表增删改查不用写 SQL直接调方法就行。改造方式是引入mybatis-plus-boot-starter依赖把 Mapper 接口改成继承BaseMapperEntityService 实现类继承ServiceImplMapper, Entity。分页查询用Page对象不用再手写 limit 语句。这样改完代码量能减少一半以上面试时聊起来也比纯 CRUD 有亮点。// 改造后的 CustomerService继承 ServiceImpl 后直接拥有 save、removeById、page 等方法 Service public class CustomerService extends ServiceImplCustomerMapper, Customer { // 自定义分页查询MyBatis-Plus 的 Page 对象自动处理 limit public PageCustomer findByPage(int page, int size, String keyword) { PageCustomer p new Page(page, size); QueryWrapperCustomer wrapper new QueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(name, keyword).or().like(phone, keyword); } return this.page(p, wrapper); } }QueryWrapper的like方法会自动拼成LIKE %keyword%不用手写 SQL。or()表示两个条件之间是 OR 关系不加的话默认是 AND。分页插件需要在配置类里注册MybatisPlusInterceptor并添加PaginationInnerInterceptor否则 page 方法不会真正分页而是查全量再内存分页数据量大时性能很差。5.2 加一层 Redis 缓存把库存查询压下去库存查询是高频操作每次进出库页面都查数据库会给 MySQL 带来压力。引入 Redis 做缓存把库存数据以stock:productId:warehouseId为 key 存起来查询时先走 Redis没有再查数据库并回写缓存。更新库存时同步删除缓存避免脏数据。Spring Boot 整合 Redis 只需要加spring-boot-starter-data-redis依赖配置 host 和 port然后用StringRedisTemplate或RedisTemplate操作。// StockService 里加缓存逻辑 Autowired private StringRedisTemplate redisTemplate; public Stock getStock(Integer productId, Integer warehouseId) { String key stock: productId : warehouseId; String cached redisTemplate.opsForValue().get(key); if (cached ! null) { return JSON.parseObject(cached, Stock.class); } Stock stock stockMapper.findByProductAndWarehouse(productId, warehouseId); if (stock ! null) { redisTemplate.opsForValue().set(key, JSON.toJSONString(stock), 10, TimeUnit.MINUTES); } return stock; }缓存过期时间设 10 分钟是权衡一致性和性能的结果。更新库存时用redisTemplate.delete(key)删缓存下次查询会重新加载。注意缓存穿透问题——如果查一个不存在的库存每次都打到数据库可以在缓存里存一个空对象并设短过期时间。这套改造做完项目就从「能跑」变成了「能扛」面试时聊缓存策略也有东西可说。5.3 用日志和监控验证系统稳定性项目跑起来之后怎么确认它稳定我一般会做三件事。第一看系统日志表里有没有异常记录特别是删除和修改操作确认每次操作都有迹可循。第二用 Postman 或 curl 对核心接口做并发测试比如同时发 50 个入库请求看库存数量对不对得上。第三在 application.yml 里把 MyBatis 的 SQL 日志打开观察实际执行的 SQL 和参数确认没有全表扫描。# 开启 MyBatis SQL 日志开发阶段用 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl打开之后控制台会打印每条 SQL 和参数能直观看到有没有走索引、有没有多余的查询。上线前记得关掉否则日志量太大。从那以后我每次交付一个项目都会先跑一遍并发测试再打开 SQL 日志扫一眼确认没有慢查询才敢说「能用了」。希望这份拆解能帮你少走弯路顺利把项目跑起来、改下去。本文还有配套的精品资源点击获取