简介一款基于Spring Boot的库存管理系统完整毕业设计资源包采用前后端分离架构面向计算机相关专业学生及自学者可用于毕业设计、课程设计或实战练习。系统覆盖登录权限、商品入库出库、库存查询统计、供应商管理等核心模块数据库设计了用户表、库存表、供应商表、商品类别表等贴合全栈开发教学需求。压缩包共434个文件大小约22.04MB以117个Java后端源码、60个Vue前端页面、SQL数据库脚本、XML配置文件为主另含论文与开题报告、批处理安装运行脚本及多媒体演示材料目录结构清晰便于按模块查阅。代码经过完整测试包含数据库文件配合运行说明可快速启动论文从需求分析、系统设计到测试结果均有阐述开题报告提供了目标、技术路线与预期成果能够支撑完成整个课设流程。目前已有46人学习浏览适合需要积累全栈项目经验或准备毕设答辩的学习者运行中遇到问题还可联系作者获得支持。1. Spring Boot 库存管理系统源码、论文和开题报告怎么配成一套赶在提交毕设前一周最怕的不是代码跑不通而是项目包打开了不知道从哪儿看起。这份基于 Spring Boot 的库存管理系统资源典型技术组合是 Spring Boot MyBatis MySQL里面同时带了源码工程、毕业论文和开题报告。你拿到的不是一堆散文件而是一套“代码能跑、论文能写、答辩能讲”的三件套。适合两类人一类是拿它当毕业设计底子换换业务字段就变成自己的库存课程设计另一类是刚学 Java 后端想拆一个完整的“商品—入库—出库—库存”进销存流程练手。下面我按拆包顺序写先看源码结构和论文怎么对应再讲怎么跑起来最后集中说最容易翻车的几个坑以及答辩时真正能用上的对账技巧。2. 拆包看结构源码分层、论文骨架与数据库表怎么一一对应拿到这类资源包我习惯先不急着启动项目而是先把目录摊开看一遍。原因很现实答辩时老师最喜欢问的不是“你写了多少行代码”而是“你这个模块在哪个类里实现的”“数据库为什么这么设计”。你如果连文件位置都说不清代码写得再漂亮也吃亏。2.1 源码目录先认 Controller、Service、Mapper 三层答辩高频提问区没有先看 porm.xml 之前不要期待好用的模块化要先确认源码是标准的 Maven 工程还是老式 Web 项目。inventory-system/ ├── src/main/java/com/example/inventory/ │ ├── controller/ # 接收前端请求返回 JSON │ │ ├── ProductController.java │ │ ├── StockInController.java │ │ └── StockOutController.java │ ├── service/ # 业务层库存出入库的核心逻辑 │ │ ├── ProductService.java │ │ └── StockService.java │ ├── mapper/ # MyBatis 接口定义 SQL 操作方法 │ │ ├── ProductMapper.java │ │ └── StockFlowMapper.java │ ├── entity/ # 与数据库表对应的实体类 │ │ ├── Product.java │ │ └── StockFlow.java │ └── common/ # 统一返回体、异常处理 ├── src/main/resources/ │ ├── mapper/ # 真正的 SQL 写在这里XML │ │ ├── ProductMapper.xml │ │ └── StockFlowMapper.xml │ ├── application.yml # 数据源、端口、MyBatis 配置 │ └── db/ │ └── init.sql # 建表脚本和初始数据 └── pom.xml大多数毕业设计风格的 Spring Boot 库存项目都是这个骨架只是包名会换。这条调用链是“前端请求 → Controller → Service → Mapper → MySQL”对应到实际文件就是Controller.java→Service.java→Mapper.java→Mapper.xml。你记住这套链路答辩时老师问“新增商品走哪条路径”你就能直接报出文件名而不是含糊说“就是那个接口”。还有一点值得注意这种模板项目大多选 MyBatis 而不是 Spring Data JPA原因是 SQL 写在 XML 里论文可以直接贴 SQL 讲实现对课设答辩更友好。2.2 论文骨架需求分析、系统设计、系统实现分别是源码里的哪一块毕业论文和开题报告不是写完代码之后补的它们本身就应该和源码互相印证。这份资源里论文的章节顺序几乎可以一一对应到工程目录论文章节对应源码或资源答辩常问点绪论与选题背景开题报告的选题意义部分为什么做库存管理系统而不是别的需求分析Product.java、StockFlow.java等实体字段功能模块有哪些角色操作权限如何划分系统设计db/init.sql的表结构设计表关系是一对多还是多对多主外键怎么设置系统实现controller/和service/下具体类出入库流程如何保证数据一致性系统测试接口调试记录或测试方法测试用例覆盖了哪些正常和异常场景开题报告在这类资源里常被忽略但它其实是最后修改成本最低的一份文档。它会提前锁定你的技术路线、功能范围、项目进度所以我的习惯是先把开题报告里的“功能目录”抄出来逐条和源码里的 URL 对应一遍。如果开题报告写了“支持库存预警”源码里却找不到对应接口那就要么补需求分析要么改开题报告而不是到答辩前才发现两边对不上。2.3 数据库设计库存表与流水表为什么必须分开库存管理系统最核心的数据设计是“库存表”和“流水表”分工现状放在 stock 表历史变更放在 stock_flow 表。当初我在课设里犯过把两张表合成一张的错结果每次查历史记录都要翻库存表逻辑一团乱。正常设计应该是这样的create table product ( id int primary key auto_increment, name varchar(64) not null, spec varchar(128), unit varchar(16), create_time datetime default current_timestamp ); create table stock ( id int primary key auto_increment, product_id int not null, quantity int not null default 0, update_time datetime default current_timestamp on update current_timestamp, unique key uk_product (product_id), foreign key (product_id) references product(id) ); create table stock_flow ( id bigint primary key auto_increment, product_id int not null, flow_type varchar(8) not null comment IN-入库 OUT-出库, quantity int not null, before_qty int not null default 0, after_qty int not null default 0, remark varchar(255), create_time datetime default current_timestamp, foreign key (product_id) references product(id) );这里面的关键点stock 表只存当前存量stock_flow 表记每一次变更而且我建议把 before_qty 和 after_qty 也带上。这么做有两个理由。第一查当前库存时只扫描 stock 一张表速度快第二一旦出现库存对不上可以用流水表的 after_qty 反推数据这一点第 5 章还会细讲。需要注意的是 flow_type 这里我用 varchar 存 IN/OUT生产级系统通常用法 tinyint 表示类型并加一个字典表但对课程设计和毕业设计来说可读性比极致性能更重要。答辩时老师反而会认可你“字段注释清楚、类型选择有理由”。3. 把项目跑起来环境配置、数据源、账户测试与出入库事务链路代码跑不起来很多问题其实出在本地环境和配置上而不是源码本身。这一章我按“环境 → 配置 → 业务代码 → 接口验证”的顺序带你走一遍每一步我都会告诉你参数为什么这么设。3.1 环境准备IDEA 社区版、JDK 版本与 Maven 一次到位先提醒一件事这套基于 Spring Boot 的库存课件如果模板是 Boot 2.xJDK 8 就能跑如果是 Boot 3.xJDK 17 是底线。打开 pom.xml 看 java.version不要用你机器上装的 JDK 版本去强行套。如果你的本地电脑上只有 IntelliJ IDEA 社区版也完全够用。社区版虽然不带 Spring Initializr 和 Spring Boot 运行面板但你可以直接用 Maven 命令启动效果一样mvn clean package -DskipTests java -jar target/inventory-system-0.0.1-SNAPSHOT.jar这里要说一下命令参数含义-DskipTests跳过测试执行但保留测试类编译本地首次跑能省掉不少编译时间target/下生成的 jar 包是 Spring Boot 内嵌 Tomcat 可直接运行的产物不需要额外装 Tomcat。如果你更习惯 VSCode也能装 Spring Boot 插件后直接点运行思路一样。3.2 application.yml 配置数据源、端口、MyBatis 驼峰映射源码包里的application.yml默认连的是本地 MySQL如果数据库密码或端口和你机器不一样需要先改这部分server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/inventory_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.inventory.entity configuration: map-underscore-to-camel-case: true每个参数都有实际作用复杂情况多举几个关键部分。数据源 URL 里useUnicode和characterEncoding是解决中文乱码的关键很多新手只写 IP 和库名导致商品名称、备注字段乱码。serverTimezoneAsia/Shanghai单独针对 MySQL 8 以下版本绕不过的时段报错问题旧版 MySQL 驱动如果不加这个启动时大概率报时区异常。map-underscore-to-camel-case是 MyBatis 的驼峰映射开关数据库字段是 product_idJava 属性是 productId打开这个配置后就自动转换。如果本机 8080 端口被占用把server.port改成别的数字就行。这种“改端口”的操作在课程设计里很常见你要把它和陈玉连起来。3.3 核心业务代码出库、入库共用一条“事务 流水”通道库存系统的业务代码全看 Service 层。以下是一个简化后的入库逻辑核心工作都在这里Service public class StockService { Autowired private StockMapper stockMapper; Autowired private StockFlowMapper stockFlowMapper; Transactional(rollbackFor Exception.class) public void stockIn(Long productId, int count) { Stock stock stockMapper.findByProductId(productId); if (stock null) { throw new RuntimeException(商品不存在不能入库); } int oldQty stock.getQuantity(); stockMapper.increaseQuantity(productId, count); StockFlow flow new StockFlow(); flow.setProductId(productId); flow.setFlowType(IN); flow.setQuantity(count); flow.setBeforeQty(oldQty); flow.setAfterQty(oldQty count); stockFlowMapper.insert(flow); } }这段代码有两个关键点。第一Transactional(rollbackFor Exception.class)表示库存更新和流水插入在同一个事务里任何一步抛异常都会回滚不会出现“库存加了但流水没记录”的情况。很多新手只给方法加注解却不指定 rollbackFor结果抛出的是 RuntimeException 还好遇到受检异常时 Spring 默认不回滚数据就残了。第二stockMapper.increaseQuantity(productId, count)执行的是 SQL 层面原子更新而不是先 select 出来再加回这样能避免两个请求并发读到同一个初始值互相覆盖。关于这件事我在下一章还会展开一遍并发拨和各种情况。3.4 用 curl 调接口验证参数怎么传、返回值怎么看启动成功后先用最简单的方式验证 controller 是否映射正确curl -X POST http://localhost:8080/stock/in \ -H Content-Type: application/json \ -d {productId: 1, count: 20}如果方便用 Postman 或 IDEA 自带 HTTP Client 都行它们本质上是同一个接口。正常返回时通常你会看到一个统一结构{ code: 200, message: 入库成功, data: null }注意这里的 code 是业务代码不是 HTTP 状态码。生产系统会把 HTTP 状态码也对应起来课程设计里只要保持统一返回结构就行。我的建议是 4 开头的 HTTP 状态码留给参数错误5 开头留给服务端异常其余业务信息放进 message 字段去描述。这样前端判断逻辑会清晰很多。4. 避坑手册Spring Boot 库存项目最常见的几个坑这一章我直接把你可能遇到的五个问题列出来每个都有“现象 → 原因 → 解决”三步。这些坑来自我拆过多个类似项目后总结的规律自然带有排障逻辑而不是单纯的预设式排查清单。4.1 MySQL 8 连接报 Public Key Retrieval 错误现象启动项目时报Public Key Retrieval is not allowed但数据库密码确实没错。原因MySQL 8 默认使用 caching_sha2_password 认证如果驱动和服务器用 SSL 方式连接第一次握手时需要获取 RSA 公钥而 JDBC 驱动默认不允许远程获取公钥。解决在数据源 URL 上追加allowPublicKeyRetrievaltrueuseSSLfalse参考第 3 章的配置即可。这个参数只在开发环境建议开启生产环境应该用证书。4.2 MyBatis 插入数据之后拿不到自增主键现象向 product 表插入一条数据代码里紧接着需要 product.getId() 当流水外键结果返回值始终是 null。原因MyBatis 不知道需要回填数据库自增主键默认插入后实体 id 不会更新。解决在 Mapper.xml 的 insert 语句里加上keyProperty和useGeneratedKeysinsert idinsert keyPropertyid useGeneratedKeystrue insert into product (name, spec, unit) values (#{name}, #{spec}, #{unit}) /insertkeyPropertyid指要把生成的自增键写入实体类的哪个属性useGeneratedKeystrue表示启用 JDBC 的 getGeneratedKeys 机制。如果不写这两行你就得把整个表结构改回到依赖 select last_insert_id() 的方式非常毛躁。4.3 库存更新成功但流水表没有记录现象调用出库接口后库存数量减少了看 stock_flow 表却发现没有新增任何行或行数不对。原因没有加事务或者加了事务但摆放位置不对。部分 MyBatis 的 update 方法是直接执行的它在自己的会话中自动提交和后面插入流水的操作不在同一事务里。解决确认 Service 方法上加了Transactional并且调用入口是从外部 Controller 进入不是同类内 this 自调用。同类方法自调用是常见陷阱Spring 事务基于 AOP 代理内部直接调用另一个方法时代理不生效等于没加事务。把操作拆到一个单独 Service 类里互相调用或者改为事务修饰一个原子方法。4.4 并发入库时库存数量不增反减现象两个测试请求同时给同一件商品入库结果库存数量变成 5而不是期望的 10。没有报错数据就错了。原因这是典型的丢了更新操作。如果先把库存查出来在 Java 里加一再 update 一次两个线程同时读到初始值为 5各自算成 6最后一个写回还是 6而不是 11。解决SQL 层面原子更新。库存表更新不依赖旧值而是在 update 语句里直接加update stock set quantity quantity #{count} where product_id #{productId}同样地出库时想要防止扣成负数可以追加条件update stock set quantity quantity - #{count} where product_id #{productId} and quantity #{count}如果受影响行数为 0说明库存不足然后抛业务异常回滚流水。这套做法能填掉并发超卖这个坑你要背下这条 SQL 的思路。4.5 接口返回中文乱码现象请求返回的 JSON 里是中文变成??或者乱码。原因常见有三处叠加。第一是数据库连接 URL 没有 characterEncoding第二是 MySQL 表本身的字符集是 latin1第三是 Spring Boot 返回 JSON 时不带 UTF-8但大多数 Java 单元逻辑对此毫不知情。解决先看建表语句是不是DEFAULT CHARSETutf8mb4再把 JDBC URL 补齐。两个都改动后才能从数据库根上解决。实际上开发默认使用 utf8mb4 是更正确的做法utf8 只是它的子集也只有 utf8mb4 才能完整存储生僻字和表情符号。4.6 排查优先级日志级别、接口清单一次看全遇到上面这些问题我的排查顺序是先看控制台第一处红色异常再查 application.yml 是否正确加载然后按第 2 章的目录结构把 Controller 层方法名和数据库表字段对齐。最后才怀疑是代码逻辑写错。如果你想把日志调得更详细可以在application.yml里把 mapper 包日志级别设为 debug这样 MyBatis 会打印出实际执行的 SQL 和参数大多数数据异常可以直接定位。5. 一个真正有用的验证技巧用库存流水反推账实是否一致做完一个库存模块只跑通接口不算真正结束。毕业设计答辩最常被问到的问题之一你怎么证明系统算出来的库存是对的这时候空口说“我测了”没说服力需要拿出一个可复现的验证方法。我的习惯是写一段对账 SQL让流水表独立计算每件商品的净变更量再和库存表现值对比。SQL 长这样select f.product_id, sum(case when f.flow_type IN then f.quantity else -f.quantity end) as calc_qty, s.quantity as stock_qty from stock_flow f left join stock s on s.product_id f.product_id group by f.product_id, s.quantity having calc_qty ! s.quantity;这个查询的逻辑是用所有入库流水减掉所有出库流水得到“理论上应该剩多少”然后和库存表的实时存量对比。如果查询结果为空说明所有流水闭合如果查出来有行说明中间出现数据断层再去定位具体是哪一天哪一笔操作异常。我当时在第一版项目里查出来一条记录入库单数量是 50出库单累计也是 50但库存表剩下 5靠这张对账表一眼看出症结点在商品调拨环节——调拨操作根本没写流水。后来我把这个验证思路写进测试章节里答辩老师看完说你这张对账表比讲十个功能都有说服力。从那以后我每次交付库存类项目都会强制跑一遍流水反推对账再收工绝不只在浏览器里点两下就结束。在你自己做课设或毕设的时候这个方法也能帮你提前发现代码里潜在的角落 bug比等到拿数据看结果时再崩溃强得多。希望帮到你。本文还有配套的精品资源点击获取
简介一款基于Spring Boot的库存管理系统完整毕业设计资源包采用前后端分离架构面向计算机相关专业学生及自学者可用于毕业设计、课程设计或实战练习。系统覆盖登录权限、商品入库出库、库存查询统计、供应商管理等核心模块数据库设计了用户表、库存表、供应商表、商品类别表等贴合全栈开发教学需求。压缩包共434个文件大小约22.04MB以117个Java后端源码、60个Vue前端页面、SQL数据库脚本、XML配置文件为主另含论文与开题报告、批处理安装运行脚本及多媒体演示材料目录结构清晰便于按模块查阅。代码经过完整测试包含数据库文件配合运行说明可快速启动论文从需求分析、系统设计到测试结果均有阐述开题报告提供了目标、技术路线与预期成果能够支撑完成整个课设流程。目前已有46人学习浏览适合需要积累全栈项目经验或准备毕设答辩的学习者运行中遇到问题还可联系作者获得支持。1. Spring Boot 库存管理系统源码、论文和开题报告怎么配成一套赶在提交毕设前一周最怕的不是代码跑不通而是项目包打开了不知道从哪儿看起。这份基于 Spring Boot 的库存管理系统资源典型技术组合是 Spring Boot MyBatis MySQL里面同时带了源码工程、毕业论文和开题报告。你拿到的不是一堆散文件而是一套“代码能跑、论文能写、答辩能讲”的三件套。适合两类人一类是拿它当毕业设计底子换换业务字段就变成自己的库存课程设计另一类是刚学 Java 后端想拆一个完整的“商品—入库—出库—库存”进销存流程练手。下面我按拆包顺序写先看源码结构和论文怎么对应再讲怎么跑起来最后集中说最容易翻车的几个坑以及答辩时真正能用上的对账技巧。2. 拆包看结构源码分层、论文骨架与数据库表怎么一一对应拿到这类资源包我习惯先不急着启动项目而是先把目录摊开看一遍。原因很现实答辩时老师最喜欢问的不是“你写了多少行代码”而是“你这个模块在哪个类里实现的”“数据库为什么这么设计”。你如果连文件位置都说不清代码写得再漂亮也吃亏。2.1 源码目录先认 Controller、Service、Mapper 三层答辩高频提问区没有先看 porm.xml 之前不要期待好用的模块化要先确认源码是标准的 Maven 工程还是老式 Web 项目。inventory-system/ ├── src/main/java/com/example/inventory/ │ ├── controller/ # 接收前端请求返回 JSON │ │ ├── ProductController.java │ │ ├── StockInController.java │ │ └── StockOutController.java │ ├── service/ # 业务层库存出入库的核心逻辑 │ │ ├── ProductService.java │ │ └── StockService.java │ ├── mapper/ # MyBatis 接口定义 SQL 操作方法 │ │ ├── ProductMapper.java │ │ └── StockFlowMapper.java │ ├── entity/ # 与数据库表对应的实体类 │ │ ├── Product.java │ │ └── StockFlow.java │ └── common/ # 统一返回体、异常处理 ├── src/main/resources/ │ ├── mapper/ # 真正的 SQL 写在这里XML │ │ ├── ProductMapper.xml │ │ └── StockFlowMapper.xml │ ├── application.yml # 数据源、端口、MyBatis 配置 │ └── db/ │ └── init.sql # 建表脚本和初始数据 └── pom.xml大多数毕业设计风格的 Spring Boot 库存项目都是这个骨架只是包名会换。这条调用链是“前端请求 → Controller → Service → Mapper → MySQL”对应到实际文件就是Controller.java→Service.java→Mapper.java→Mapper.xml。你记住这套链路答辩时老师问“新增商品走哪条路径”你就能直接报出文件名而不是含糊说“就是那个接口”。还有一点值得注意这种模板项目大多选 MyBatis 而不是 Spring Data JPA原因是 SQL 写在 XML 里论文可以直接贴 SQL 讲实现对课设答辩更友好。2.2 论文骨架需求分析、系统设计、系统实现分别是源码里的哪一块毕业论文和开题报告不是写完代码之后补的它们本身就应该和源码互相印证。这份资源里论文的章节顺序几乎可以一一对应到工程目录论文章节对应源码或资源答辩常问点绪论与选题背景开题报告的选题意义部分为什么做库存管理系统而不是别的需求分析Product.java、StockFlow.java等实体字段功能模块有哪些角色操作权限如何划分系统设计db/init.sql的表结构设计表关系是一对多还是多对多主外键怎么设置系统实现controller/和service/下具体类出入库流程如何保证数据一致性系统测试接口调试记录或测试方法测试用例覆盖了哪些正常和异常场景开题报告在这类资源里常被忽略但它其实是最后修改成本最低的一份文档。它会提前锁定你的技术路线、功能范围、项目进度所以我的习惯是先把开题报告里的“功能目录”抄出来逐条和源码里的 URL 对应一遍。如果开题报告写了“支持库存预警”源码里却找不到对应接口那就要么补需求分析要么改开题报告而不是到答辩前才发现两边对不上。2.3 数据库设计库存表与流水表为什么必须分开库存管理系统最核心的数据设计是“库存表”和“流水表”分工现状放在 stock 表历史变更放在 stock_flow 表。当初我在课设里犯过把两张表合成一张的错结果每次查历史记录都要翻库存表逻辑一团乱。正常设计应该是这样的create table product ( id int primary key auto_increment, name varchar(64) not null, spec varchar(128), unit varchar(16), create_time datetime default current_timestamp ); create table stock ( id int primary key auto_increment, product_id int not null, quantity int not null default 0, update_time datetime default current_timestamp on update current_timestamp, unique key uk_product (product_id), foreign key (product_id) references product(id) ); create table stock_flow ( id bigint primary key auto_increment, product_id int not null, flow_type varchar(8) not null comment IN-入库 OUT-出库, quantity int not null, before_qty int not null default 0, after_qty int not null default 0, remark varchar(255), create_time datetime default current_timestamp, foreign key (product_id) references product(id) );这里面的关键点stock 表只存当前存量stock_flow 表记每一次变更而且我建议把 before_qty 和 after_qty 也带上。这么做有两个理由。第一查当前库存时只扫描 stock 一张表速度快第二一旦出现库存对不上可以用流水表的 after_qty 反推数据这一点第 5 章还会细讲。需要注意的是 flow_type 这里我用 varchar 存 IN/OUT生产级系统通常用法 tinyint 表示类型并加一个字典表但对课程设计和毕业设计来说可读性比极致性能更重要。答辩时老师反而会认可你“字段注释清楚、类型选择有理由”。3. 把项目跑起来环境配置、数据源、账户测试与出入库事务链路代码跑不起来很多问题其实出在本地环境和配置上而不是源码本身。这一章我按“环境 → 配置 → 业务代码 → 接口验证”的顺序带你走一遍每一步我都会告诉你参数为什么这么设。3.1 环境准备IDEA 社区版、JDK 版本与 Maven 一次到位先提醒一件事这套基于 Spring Boot 的库存课件如果模板是 Boot 2.xJDK 8 就能跑如果是 Boot 3.xJDK 17 是底线。打开 pom.xml 看 java.version不要用你机器上装的 JDK 版本去强行套。如果你的本地电脑上只有 IntelliJ IDEA 社区版也完全够用。社区版虽然不带 Spring Initializr 和 Spring Boot 运行面板但你可以直接用 Maven 命令启动效果一样mvn clean package -DskipTests java -jar target/inventory-system-0.0.1-SNAPSHOT.jar这里要说一下命令参数含义-DskipTests跳过测试执行但保留测试类编译本地首次跑能省掉不少编译时间target/下生成的 jar 包是 Spring Boot 内嵌 Tomcat 可直接运行的产物不需要额外装 Tomcat。如果你更习惯 VSCode也能装 Spring Boot 插件后直接点运行思路一样。3.2 application.yml 配置数据源、端口、MyBatis 驼峰映射源码包里的application.yml默认连的是本地 MySQL如果数据库密码或端口和你机器不一样需要先改这部分server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/inventory_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.inventory.entity configuration: map-underscore-to-camel-case: true每个参数都有实际作用复杂情况多举几个关键部分。数据源 URL 里useUnicode和characterEncoding是解决中文乱码的关键很多新手只写 IP 和库名导致商品名称、备注字段乱码。serverTimezoneAsia/Shanghai单独针对 MySQL 8 以下版本绕不过的时段报错问题旧版 MySQL 驱动如果不加这个启动时大概率报时区异常。map-underscore-to-camel-case是 MyBatis 的驼峰映射开关数据库字段是 product_idJava 属性是 productId打开这个配置后就自动转换。如果本机 8080 端口被占用把server.port改成别的数字就行。这种“改端口”的操作在课程设计里很常见你要把它和陈玉连起来。3.3 核心业务代码出库、入库共用一条“事务 流水”通道库存系统的业务代码全看 Service 层。以下是一个简化后的入库逻辑核心工作都在这里Service public class StockService { Autowired private StockMapper stockMapper; Autowired private StockFlowMapper stockFlowMapper; Transactional(rollbackFor Exception.class) public void stockIn(Long productId, int count) { Stock stock stockMapper.findByProductId(productId); if (stock null) { throw new RuntimeException(商品不存在不能入库); } int oldQty stock.getQuantity(); stockMapper.increaseQuantity(productId, count); StockFlow flow new StockFlow(); flow.setProductId(productId); flow.setFlowType(IN); flow.setQuantity(count); flow.setBeforeQty(oldQty); flow.setAfterQty(oldQty count); stockFlowMapper.insert(flow); } }这段代码有两个关键点。第一Transactional(rollbackFor Exception.class)表示库存更新和流水插入在同一个事务里任何一步抛异常都会回滚不会出现“库存加了但流水没记录”的情况。很多新手只给方法加注解却不指定 rollbackFor结果抛出的是 RuntimeException 还好遇到受检异常时 Spring 默认不回滚数据就残了。第二stockMapper.increaseQuantity(productId, count)执行的是 SQL 层面原子更新而不是先 select 出来再加回这样能避免两个请求并发读到同一个初始值互相覆盖。关于这件事我在下一章还会展开一遍并发拨和各种情况。3.4 用 curl 调接口验证参数怎么传、返回值怎么看启动成功后先用最简单的方式验证 controller 是否映射正确curl -X POST http://localhost:8080/stock/in \ -H Content-Type: application/json \ -d {productId: 1, count: 20}如果方便用 Postman 或 IDEA 自带 HTTP Client 都行它们本质上是同一个接口。正常返回时通常你会看到一个统一结构{ code: 200, message: 入库成功, data: null }注意这里的 code 是业务代码不是 HTTP 状态码。生产系统会把 HTTP 状态码也对应起来课程设计里只要保持统一返回结构就行。我的建议是 4 开头的 HTTP 状态码留给参数错误5 开头留给服务端异常其余业务信息放进 message 字段去描述。这样前端判断逻辑会清晰很多。4. 避坑手册Spring Boot 库存项目最常见的几个坑这一章我直接把你可能遇到的五个问题列出来每个都有“现象 → 原因 → 解决”三步。这些坑来自我拆过多个类似项目后总结的规律自然带有排障逻辑而不是单纯的预设式排查清单。4.1 MySQL 8 连接报 Public Key Retrieval 错误现象启动项目时报Public Key Retrieval is not allowed但数据库密码确实没错。原因MySQL 8 默认使用 caching_sha2_password 认证如果驱动和服务器用 SSL 方式连接第一次握手时需要获取 RSA 公钥而 JDBC 驱动默认不允许远程获取公钥。解决在数据源 URL 上追加allowPublicKeyRetrievaltrueuseSSLfalse参考第 3 章的配置即可。这个参数只在开发环境建议开启生产环境应该用证书。4.2 MyBatis 插入数据之后拿不到自增主键现象向 product 表插入一条数据代码里紧接着需要 product.getId() 当流水外键结果返回值始终是 null。原因MyBatis 不知道需要回填数据库自增主键默认插入后实体 id 不会更新。解决在 Mapper.xml 的 insert 语句里加上keyProperty和useGeneratedKeysinsert idinsert keyPropertyid useGeneratedKeystrue insert into product (name, spec, unit) values (#{name}, #{spec}, #{unit}) /insertkeyPropertyid指要把生成的自增键写入实体类的哪个属性useGeneratedKeystrue表示启用 JDBC 的 getGeneratedKeys 机制。如果不写这两行你就得把整个表结构改回到依赖 select last_insert_id() 的方式非常毛躁。4.3 库存更新成功但流水表没有记录现象调用出库接口后库存数量减少了看 stock_flow 表却发现没有新增任何行或行数不对。原因没有加事务或者加了事务但摆放位置不对。部分 MyBatis 的 update 方法是直接执行的它在自己的会话中自动提交和后面插入流水的操作不在同一事务里。解决确认 Service 方法上加了Transactional并且调用入口是从外部 Controller 进入不是同类内 this 自调用。同类方法自调用是常见陷阱Spring 事务基于 AOP 代理内部直接调用另一个方法时代理不生效等于没加事务。把操作拆到一个单独 Service 类里互相调用或者改为事务修饰一个原子方法。4.4 并发入库时库存数量不增反减现象两个测试请求同时给同一件商品入库结果库存数量变成 5而不是期望的 10。没有报错数据就错了。原因这是典型的丢了更新操作。如果先把库存查出来在 Java 里加一再 update 一次两个线程同时读到初始值为 5各自算成 6最后一个写回还是 6而不是 11。解决SQL 层面原子更新。库存表更新不依赖旧值而是在 update 语句里直接加update stock set quantity quantity #{count} where product_id #{productId}同样地出库时想要防止扣成负数可以追加条件update stock set quantity quantity - #{count} where product_id #{productId} and quantity #{count}如果受影响行数为 0说明库存不足然后抛业务异常回滚流水。这套做法能填掉并发超卖这个坑你要背下这条 SQL 的思路。4.5 接口返回中文乱码现象请求返回的 JSON 里是中文变成??或者乱码。原因常见有三处叠加。第一是数据库连接 URL 没有 characterEncoding第二是 MySQL 表本身的字符集是 latin1第三是 Spring Boot 返回 JSON 时不带 UTF-8但大多数 Java 单元逻辑对此毫不知情。解决先看建表语句是不是DEFAULT CHARSETutf8mb4再把 JDBC URL 补齐。两个都改动后才能从数据库根上解决。实际上开发默认使用 utf8mb4 是更正确的做法utf8 只是它的子集也只有 utf8mb4 才能完整存储生僻字和表情符号。4.6 排查优先级日志级别、接口清单一次看全遇到上面这些问题我的排查顺序是先看控制台第一处红色异常再查 application.yml 是否正确加载然后按第 2 章的目录结构把 Controller 层方法名和数据库表字段对齐。最后才怀疑是代码逻辑写错。如果你想把日志调得更详细可以在application.yml里把 mapper 包日志级别设为 debug这样 MyBatis 会打印出实际执行的 SQL 和参数大多数数据异常可以直接定位。5. 一个真正有用的验证技巧用库存流水反推账实是否一致做完一个库存模块只跑通接口不算真正结束。毕业设计答辩最常被问到的问题之一你怎么证明系统算出来的库存是对的这时候空口说“我测了”没说服力需要拿出一个可复现的验证方法。我的习惯是写一段对账 SQL让流水表独立计算每件商品的净变更量再和库存表现值对比。SQL 长这样select f.product_id, sum(case when f.flow_type IN then f.quantity else -f.quantity end) as calc_qty, s.quantity as stock_qty from stock_flow f left join stock s on s.product_id f.product_id group by f.product_id, s.quantity having calc_qty ! s.quantity;这个查询的逻辑是用所有入库流水减掉所有出库流水得到“理论上应该剩多少”然后和库存表的实时存量对比。如果查询结果为空说明所有流水闭合如果查出来有行说明中间出现数据断层再去定位具体是哪一天哪一笔操作异常。我当时在第一版项目里查出来一条记录入库单数量是 50出库单累计也是 50但库存表剩下 5靠这张对账表一眼看出症结点在商品调拨环节——调拨操作根本没写流水。后来我把这个验证思路写进测试章节里答辩老师看完说你这张对账表比讲十个功能都有说服力。从那以后我每次交付库存类项目都会强制跑一遍流水反推对账再收工绝不只在浏览器里点两下就结束。在你自己做课设或毕设的时候这个方法也能帮你提前发现代码里潜在的角落 bug比等到拿数据看结果时再崩溃强得多。希望帮到你。本文还有配套的精品资源点击获取
