拓冰网站定制 
简介本资源为基于WEB的仓库管理系统毕业设计完整资料包面向计算机相关专业需要完成课程设计或毕业设计的学生以及希望学习Java Web项目开发与业务逻辑实现的初学者。系统围绕仓库出入库核心业务展开涵盖入库模块新商品入库与已有商品补货、出库模块对已入库商品执行出库操作、商品查看模块实时查询库存商品信息、用户注册模块账号密码及用户信息注册以及个人信息管理模块查看与修改个人资料结构清晰适合作为Web开发入门与实战参考。压缩包为rar格式整体约62.5MB内含源码、数据库、演示视频与论文等文件可帮助读者快速理解项目架构、数据库表设计与各功能模块的实现思路并对照论文梳理设计流程与关键代码。目前已有205人学习下载适合需要完整项目案例、论文素材与实操演示的读者参考使用。1. 从一份 .rar 说起WEB 仓库管理系统到底交付了什么很多人第一次接触「基于WEB的仓库管理系统」这个标题是在课程设计、毕设选题或者接私活的场景里。压缩包里通常躺着四样东西一份能跑起来的源码、一个建好表的数据库脚本、一段演示视频、一篇照着模板写的论文。看起来是「一条龙」但真正动手的人很快会发现视频里点几下就入库出库的流畅画面和自己把源码拖进 IDE 之后满屏飘红的报错完全是两回事。这个标题真正要解决的问题不是「有没有系统」而是「这套 WEB 仓库管理系统能不能在本地跑通、数据库能不能对上、二次改功能会不会崩」。仓库管理系统WMS的核心业务其实很朴素物料有档案入库有单据出库有单据库存要能实时算出来最好还能查流水、做盘点、分角色。难点从来不在业务本身而在于 WEB 这一层怎么把「浏览器请求 → 后端逻辑 → 数据库事务」串成一条不出错的链路。库存扣减如果没放进事务两个人同时出库就会超卖入库单和库存表如果靠前端算好再提交网络一抖数据就错位。所以这套东西值不值得做取决于你是想交个作业还是想拿它当练手 WEB 全栈的真实靶子。这篇文章面向三类人手里已经有一个类似压缩包、想把它跑起来并看懂的人准备自己从零写一套仓库管理系统、想知道技术选型和表结构怎么定的人以及想把现成系统改造成能用的内部小工具的人。下面按「先跑通 → 再拆解 → 再避坑 → 再进阶」的顺序讲源码、数据库、部署、排错都会落到具体命令和参数上。热搜里那些 web 项目、数据库增删改查、MySQL 连接池之类的词其实就是这条链路上的一个个卡点我会在对应位置把它们讲透。2. 跑通一套 WEB 仓库管理系统环境、数据库与启动顺序拿到源码别急着点运行先做一件事把项目结构看清楚。典型的 Java WEB 仓库管理系统是 Spring Boot MyBatis MySQL 的组合前端可能是 JSP、Thymeleaf也可能是 Vue 打包后的静态资源。目录里一般有src/main/java后端代码、src/main/resources配置和 mapper、sql或db文件夹建库脚本、pom.xml或package.json依赖。先确认技术栈再决定装什么环境这一步错了后面全是白费功夫。2.1 先读 pom.xml 和配置文件确定技术栈与端口打开pom.xml重点看三样Spring Boot 版本、数据库驱动、有没有引入连接池HikariCP 或 Druid。Spring Boot 2.x 和 3.x 在 JDK 要求上差别很大2.x 用 JDK 8 就能跑3.x 基本要 JDK 17。数据库驱动如果是mysql-connector-java老版本连 MySQL 8 会报时区或 SSL 的错。连接池决定了你后面调参的方向HikariCP 是 Spring Boot 默认的Druid 通常带监控页面。!-- pom.xml 关键片段看这三处就能判断环境 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.6/version !-- 2.x 用 JDK83.x 要 JDK17 -- /parent dependencies dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.30/version !-- 8.x 驱动连 MySQL8 要配时区 -- /dependency dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.15/version !-- 带监控页面的连接池 -- /dependency /dependencies逻辑说明spring-boot-starter-parent的版本决定了整个项目的依赖基线和 JDK 下限先看它再装 JDK能省掉一半「Unsupported class file major version」的报错。数据库驱动版本要和本机 MySQL 大版本对齐8.x 驱动连 5.7 一般没问题反过来 5.x 驱动连 8.0 大概率报Unknown system variable。连接池类型影响application.yml里配置项的名字Druid 用spring.datasource.druid.*HikariCP 用spring.datasource.hikari.*写错了配置不生效还不报错属于典型玄学。2.2 用 SQL 脚本建库把字符集和引擎一次定死数据库脚本通常在sql/目录下文件名类似warehouse.sql。导入之前先手动建库别指望脚本里的CREATE DATABASE一定带对了字符集。仓库管理系统里物料名称、供应商、备注这些字段全是中文字符集设错就是一堆问号。# 1. 登录 MySQL mysql -u root -p # 2. 建库字符集和排序规则一次定死避免中文乱码 CREATE DATABASE warehouse DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 3. 切库后导入脚本在系统命令行执行不是 MySQL 交互里 mysql -u root -p warehouse sql/warehouse.sql # 4. 验证表是否建全 mysql -u root -p -e USE warehouse; SHOW TABLES;逻辑说明utf8mb4而不是utf8因为 MySQL 的utf8实际只有 3 字节存不了 emoji 和部分生僻字物料备注里一旦出现就截断报错。utf8mb4_general_ci是通用排序规则够用且兼容性好。导入用系统命令行的重定向而不是进 MySQL 里source是因为脚本里如果有USE语句或编码声明重定向方式更稳。导入后SHOW TABLES应该能看到user、material、stock、inbound、outbound这几张核心表少一张后面功能就会 500。2.3 改 application.yml数据库连接、端口、连接池三个必调项配置文件是跑通的关键src/main/resources/application.yml或.properties里改三处数据库账号密码、服务端口、连接池参数。很多人卡在「启动成功但一访问就报错」八成是这里没对上。server: port: 8080 # 被占用就换 8081别和本机其他服务撞 spring: datasource: url: jdbc:mysql://localhost:3306/warehouse?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver hikari: maximum-pool-size: 10 # 小项目 10 够用别盲目调大 minimum-idle: 2 connection-timeout: 30000 # 30 秒拿不到连接就报错便于定位 idle-timeout: 600000逻辑说明serverTimezoneAsia/Shanghai是 MySQL 8 驱动的必填项不写会报The server time zone value is unrecognized。useSSLfalse在本地开发关掉省去证书配置。allowPublicKeyRetrievaltrue是 MySQL 8 默认加密插件下的必需参数不加会报Public Key Retrieval is not allowed。连接池maximum-pool-size设 10 是因为本地开发并发极低设成 100 反而占内存connection-timeout设 30 秒是为了让连接问题快速暴露而不是无限等待。改完这些mvn spring-boot:run或直接跑主类看到Started Application就算过了第一关。3. 拆开看仓库管理系统的表结构与库存扣减逻辑跑通只是开始真正决定这套系统能不能改、能不能用的是数据库表设计和库存计算逻辑。仓库管理系统的表结构如果一开始没设计好后面加个「批次管理」或者「多仓库」就要动全身。这一章把核心表拆开讲再落到库存扣减这个最容易出 bug 的地方。3.1 五张核心表物料、库存、入库、出库、用户一个能用的仓库管理系统最少要有这五张表。物料表存档案库存表存当前数量入库出库表存单据用户表管权限。关键是库存表不要和物料表合并否则每次查库存都要扫全表而且没法记录多仓库。表名作用关键字段注意点material物料档案id, code, name, unit, categorycode 建唯一索引防重复录入stock实时库存id, material_id, warehouse_id, quantitymaterial_id warehouse_id 建联合唯一索引inbound入库单id, material_id, quantity, operator, create_timequantity 用 int 或 decimal别用 floatoutbound出库单id, material_id, quantity, operator, create_time同上出库数量不能为负user用户与角色id, username, password, rolepassword 存 BCrypt 哈希别存明文逻辑说明stock表的联合唯一索引是防止同一物料在同一仓库出现两条记录这是库存对不上的常见根因。quantity用int存整数件数用decimal(12,2)存带小数的重量或体积绝对不要用float浮点累加会出现0.30000000000000004这种值盘点时对不上账。user表密码必须哈希现成源码里如果存的是明文第一件事就是改掉这是 web 安全最基本的底线。3.2 库存扣减必须放进事务用行锁防超卖出库时「查库存 → 判断够不够 → 扣减」这三步如果不在一个事务里两个人同时出库同一物料就会超卖。正确做法是用SELECT ... FOR UPDATE锁住那一行再判断再更新。// Service 层出库核心逻辑Transactional 保证原子性 Transactional(rollbackFor Exception.class) public void outbound(Long materialId, Long warehouseId, int qty) { // 1. 行锁查库存锁住这条记录直到事务提交 Stock stock stockMapper.selectForUpdate(materialId, warehouseId); if (stock null) { throw new BizException(该物料在此仓库无库存记录); } // 2. 判断是否够扣 if (stock.getQuantity() qty) { throw new BizException(库存不足当前可用 stock.getQuantity()); } // 3. 扣减并写回 stock.setQuantity(stock.getQuantity() - qty); stockMapper.updateById(stock); // 4. 写出库单 outboundMapper.insert(new Outbound(materialId, warehouseId, qty)); }逻辑说明Transactional的rollbackFor Exception.class保证任何异常都回滚默认只回滚运行时异常业务异常如果不显式声明就不会回滚这是血泪经验。selectForUpdate对应的 SQL 是SELECT * FROM stock WHERE material_id? AND warehouse_id? FOR UPDATE它会在事务提交前锁住这一行第二个并发请求会阻塞等待从而避免超卖。参数上qty必须做正数校验负数出库等于变相入库是常见漏洞。这套逻辑在单机 MySQL 上够用如果将来上多实例要考虑用乐观锁版本号或分布式锁但那是后话。3.3 用 MyBatis 写增删改查mapper 与 XML 的对应关系现成源码大多用 MyBatismapper接口和 XML 文件一一对应。改功能时最容易出错的是「接口方法名和 XML 的 id 对不上」启动不报错一调用就Invalid bound statement。!-- StockMapper.xml 片段 -- mapper namespacecom.example.mapper.StockMapper !-- id 必须和接口方法名完全一致 -- select idselectForUpdate resultTypecom.example.entity.Stock SELECT * FROM stock WHERE material_id #{materialId} AND warehouse_id #{warehouseId} FOR UPDATE /select update idupdateById UPDATE stock SET quantity #{quantity} WHERE id #{id} /update /mapper逻辑说明namespace要指向接口的全限定名id要和接口方法名一字不差resultType要写实体类的全路径。#{materialId}是预编译占位符能防 SQL 注入如果写成${materialId}就是字符串拼接存在注入风险这是 web 安全里最基础的坑。改完 XML 记得重新编译IDEA 有时不会自动热加载 mapper 文件导致改了没生效白排查半天。4. 避坑与排查跑不起来、数据不对、越改越乱这一章集中讲实操里最常撞的几类问题每条按「现象 → 原因 → 解决」写。这些问题在现成源码里出现频率极高提前知道能省下大量时间。4.1 启动报错端口占用与 JDK 版本不匹配现象mvn spring-boot:run报Port 8080 was already in use或者报Unsupported class file major version 61。原因前者是本机 8080 被别的服务占了后者是项目要 JDK 17 但你用的是 JDK 861 对应 JDK 17。解决端口占用就改server.port或杀掉占用进程Windows 用netstat -ano | findstr 8080找 PID 再taskkillLinux 用lsof -i:8080。JDK 版本问题就装对应版本用java -version确认IDEA 里还要在 Project Structure 里把 SDK 和 Language Level 都改对只改一处不生效。4.2 中文乱码从数据库到页面的三层字符集现象物料名称存进去是问号或者页面显示æç©。原因字符集在数据库、连接、页面三层里有一层没设对。解决数据库层确认建库用了utf8mb4连接层在 JDBC URL 里加useUnicodetruecharacterEncodingutf8页面层确认 HTML 有meta charsetUTF-8JSP 还要在顶部加% page contentTypetext/html;charsetUTF-8 %。三层都对了才不会乱码只改一层往往还是花屏。4.3 库存对不上并发扣减与浮点累加现象盘点时库存比实际少或者出现小数尾数。原因出库逻辑没加事务和行锁并发下超卖或者数量字段用了float。解决按 3.2 的方式加Transactional和FOR UPDATE把数量字段改成int或decimal已经存了脏数据的要写脚本清洗。这个问题在演示视频里看不出来因为视频是单人操作一上真实并发就暴露。4.4 改功能后 500mapper 绑定失败与字段名不一致现象加了个查询方法启动正常一调用报Invalid bound statement (not found)。原因mapper 接口方法名和 XML 的id不一致或者 XML 没被扫描到。解决核对方法名和 id确认application.yml里mybatis.mapper-locations指向了正确的路径比如classpath:mapper/*.xml。另一个常见情况是实体类字段和数据库列名不一致resultType映射不上需要在 XML 里写resultMap或用mapUnderscoreToCamelCasetrue开启驼峰转换。4.5 连接池耗尽连接没关与池子太小现象跑一段时间后报Connection is not available, request timed out。原因手写 JDBC 代码忘了关连接或者连接池maximum-pool-size设太小。解决用 MyBatis 或 JPA 时连接由框架管理一般不会泄漏如果是手写 JDBC必须try-with-resources或 finally 里 close。池子大小按并发量估本地开发 10 够用生产环境要结合数据库最大连接数来定盲目调大反而拖垮数据库。5. 进阶把现成系统改成能用的内部工具跑通、看懂、避坑之后最后一个问题是这套东西怎么从「能演示」变成「能干活」。现成源码通常缺三样东西——操作日志、数据导出、权限细分。补上这三样它就能当小团队内部工具用。操作日志最省事的做法是用 AOP 切面在入库、出库、删除这些方法上打注解自动记录操作人、时间、参数。数据导出用 EasyExcel 或 POI把库存表导成 Excel注意大数据量要分页查再写别一次select *全捞进内存。权限细分是在user表加role字段用拦截器判断 URL 前缀比如/admin/**只允许管理员访问。// AOP 记录操作日志的切面核心 Aspect Component public class LogAspect { Around(annotation(com.example.annotation.OpLog)) public Object record(ProceedingJoinPoint pjp) throws Throwable { long start System.currentTimeMillis(); Object result pjp.proceed(); // 执行原方法 long cost System.currentTimeMillis() - start; // 记录方法名、参数、耗时、当前登录用户 logService.save(pjp.getSignature().getName(), Arrays.toString(pjp.getArgs()), cost); return result; } }逻辑说明Around环绕通知能在方法执行前后都插逻辑pjp.proceed()是真正调用原方法别忘了返回它的结果否则接口返回 null。annotation限定只拦截打了OpLog注解的方法避免日志爆炸。耗时统计对排查慢接口很有用仓库管理系统里出库和盘点查询最容易慢有了这个数据就知道该给哪张表加索引。验证改造是否成功有个简单办法开两个浏览器一个用管理员登录一个用普通操作员登录同时操作同一物料看权限拦截和库存扣减是否都正确。再导出一次库存 Excel和数据库SELECT的结果对一遍数字一致才算过关。我自己踩过最深的坑是早期图省事把库存数量直接在前端算好再提交结果网络一卡就错位后来全部改成后端事务里算再没出过账实不符。做这类系统凡是涉及数量的操作一律不信前端一律进事务这个习惯比任何框架都值钱。希望帮到你。本文还有配套的精品资源点击获取 基于WEB的仓库管理系统实战：从跑通到避坑的完整指南
简介本资源为基于WEB的仓库管理系统毕业设计完整资料包面向计算机相关专业需要完成课程设计或毕业设计的学生以及希望学习Java Web项目开发与业务逻辑实现的初学者。系统围绕仓库出入库核心业务展开涵盖入库模块新商品入库与已有商品补货、出库模块对已入库商品执行出库操作、商品查看模块实时查询库存商品信息、用户注册模块账号密码及用户信息注册以及个人信息管理模块查看与修改个人资料结构清晰适合作为Web开发入门与实战参考。压缩包为rar格式整体约62.5MB内含源码、数据库、演示视频与论文等文件可帮助读者快速理解项目架构、数据库表设计与各功能模块的实现思路并对照论文梳理设计流程与关键代码。目前已有205人学习下载适合需要完整项目案例、论文素材与实操演示的读者参考使用。1. 从一份 .rar 说起WEB 仓库管理系统到底交付了什么很多人第一次接触「基于WEB的仓库管理系统」这个标题是在课程设计、毕设选题或者接私活的场景里。压缩包里通常躺着四样东西一份能跑起来的源码、一个建好表的数据库脚本、一段演示视频、一篇照着模板写的论文。看起来是「一条龙」但真正动手的人很快会发现视频里点几下就入库出库的流畅画面和自己把源码拖进 IDE 之后满屏飘红的报错完全是两回事。这个标题真正要解决的问题不是「有没有系统」而是「这套 WEB 仓库管理系统能不能在本地跑通、数据库能不能对上、二次改功能会不会崩」。仓库管理系统WMS的核心业务其实很朴素物料有档案入库有单据出库有单据库存要能实时算出来最好还能查流水、做盘点、分角色。难点从来不在业务本身而在于 WEB 这一层怎么把「浏览器请求 → 后端逻辑 → 数据库事务」串成一条不出错的链路。库存扣减如果没放进事务两个人同时出库就会超卖入库单和库存表如果靠前端算好再提交网络一抖数据就错位。所以这套东西值不值得做取决于你是想交个作业还是想拿它当练手 WEB 全栈的真实靶子。这篇文章面向三类人手里已经有一个类似压缩包、想把它跑起来并看懂的人准备自己从零写一套仓库管理系统、想知道技术选型和表结构怎么定的人以及想把现成系统改造成能用的内部小工具的人。下面按「先跑通 → 再拆解 → 再避坑 → 再进阶」的顺序讲源码、数据库、部署、排错都会落到具体命令和参数上。热搜里那些 web 项目、数据库增删改查、MySQL 连接池之类的词其实就是这条链路上的一个个卡点我会在对应位置把它们讲透。2. 跑通一套 WEB 仓库管理系统环境、数据库与启动顺序拿到源码别急着点运行先做一件事把项目结构看清楚。典型的 Java WEB 仓库管理系统是 Spring Boot MyBatis MySQL 的组合前端可能是 JSP、Thymeleaf也可能是 Vue 打包后的静态资源。目录里一般有src/main/java后端代码、src/main/resources配置和 mapper、sql或db文件夹建库脚本、pom.xml或package.json依赖。先确认技术栈再决定装什么环境这一步错了后面全是白费功夫。2.1 先读 pom.xml 和配置文件确定技术栈与端口打开pom.xml重点看三样Spring Boot 版本、数据库驱动、有没有引入连接池HikariCP 或 Druid。Spring Boot 2.x 和 3.x 在 JDK 要求上差别很大2.x 用 JDK 8 就能跑3.x 基本要 JDK 17。数据库驱动如果是mysql-connector-java老版本连 MySQL 8 会报时区或 SSL 的错。连接池决定了你后面调参的方向HikariCP 是 Spring Boot 默认的Druid 通常带监控页面。!-- pom.xml 关键片段看这三处就能判断环境 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.6/version !-- 2.x 用 JDK83.x 要 JDK17 -- /parent dependencies dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.30/version !-- 8.x 驱动连 MySQL8 要配时区 -- /dependency dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.15/version !-- 带监控页面的连接池 -- /dependency /dependencies逻辑说明spring-boot-starter-parent的版本决定了整个项目的依赖基线和 JDK 下限先看它再装 JDK能省掉一半「Unsupported class file major version」的报错。数据库驱动版本要和本机 MySQL 大版本对齐8.x 驱动连 5.7 一般没问题反过来 5.x 驱动连 8.0 大概率报Unknown system variable。连接池类型影响application.yml里配置项的名字Druid 用spring.datasource.druid.*HikariCP 用spring.datasource.hikari.*写错了配置不生效还不报错属于典型玄学。2.2 用 SQL 脚本建库把字符集和引擎一次定死数据库脚本通常在sql/目录下文件名类似warehouse.sql。导入之前先手动建库别指望脚本里的CREATE DATABASE一定带对了字符集。仓库管理系统里物料名称、供应商、备注这些字段全是中文字符集设错就是一堆问号。# 1. 登录 MySQL mysql -u root -p # 2. 建库字符集和排序规则一次定死避免中文乱码 CREATE DATABASE warehouse DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 3. 切库后导入脚本在系统命令行执行不是 MySQL 交互里 mysql -u root -p warehouse sql/warehouse.sql # 4. 验证表是否建全 mysql -u root -p -e USE warehouse; SHOW TABLES;逻辑说明utf8mb4而不是utf8因为 MySQL 的utf8实际只有 3 字节存不了 emoji 和部分生僻字物料备注里一旦出现就截断报错。utf8mb4_general_ci是通用排序规则够用且兼容性好。导入用系统命令行的重定向而不是进 MySQL 里source是因为脚本里如果有USE语句或编码声明重定向方式更稳。导入后SHOW TABLES应该能看到user、material、stock、inbound、outbound这几张核心表少一张后面功能就会 500。2.3 改 application.yml数据库连接、端口、连接池三个必调项配置文件是跑通的关键src/main/resources/application.yml或.properties里改三处数据库账号密码、服务端口、连接池参数。很多人卡在「启动成功但一访问就报错」八成是这里没对上。server: port: 8080 # 被占用就换 8081别和本机其他服务撞 spring: datasource: url: jdbc:mysql://localhost:3306/warehouse?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver hikari: maximum-pool-size: 10 # 小项目 10 够用别盲目调大 minimum-idle: 2 connection-timeout: 30000 # 30 秒拿不到连接就报错便于定位 idle-timeout: 600000逻辑说明serverTimezoneAsia/Shanghai是 MySQL 8 驱动的必填项不写会报The server time zone value is unrecognized。useSSLfalse在本地开发关掉省去证书配置。allowPublicKeyRetrievaltrue是 MySQL 8 默认加密插件下的必需参数不加会报Public Key Retrieval is not allowed。连接池maximum-pool-size设 10 是因为本地开发并发极低设成 100 反而占内存connection-timeout设 30 秒是为了让连接问题快速暴露而不是无限等待。改完这些mvn spring-boot:run或直接跑主类看到Started Application就算过了第一关。3. 拆开看仓库管理系统的表结构与库存扣减逻辑跑通只是开始真正决定这套系统能不能改、能不能用的是数据库表设计和库存计算逻辑。仓库管理系统的表结构如果一开始没设计好后面加个「批次管理」或者「多仓库」就要动全身。这一章把核心表拆开讲再落到库存扣减这个最容易出 bug 的地方。3.1 五张核心表物料、库存、入库、出库、用户一个能用的仓库管理系统最少要有这五张表。物料表存档案库存表存当前数量入库出库表存单据用户表管权限。关键是库存表不要和物料表合并否则每次查库存都要扫全表而且没法记录多仓库。表名作用关键字段注意点material物料档案id, code, name, unit, categorycode 建唯一索引防重复录入stock实时库存id, material_id, warehouse_id, quantitymaterial_id warehouse_id 建联合唯一索引inbound入库单id, material_id, quantity, operator, create_timequantity 用 int 或 decimal别用 floatoutbound出库单id, material_id, quantity, operator, create_time同上出库数量不能为负user用户与角色id, username, password, rolepassword 存 BCrypt 哈希别存明文逻辑说明stock表的联合唯一索引是防止同一物料在同一仓库出现两条记录这是库存对不上的常见根因。quantity用int存整数件数用decimal(12,2)存带小数的重量或体积绝对不要用float浮点累加会出现0.30000000000000004这种值盘点时对不上账。user表密码必须哈希现成源码里如果存的是明文第一件事就是改掉这是 web 安全最基本的底线。3.2 库存扣减必须放进事务用行锁防超卖出库时「查库存 → 判断够不够 → 扣减」这三步如果不在一个事务里两个人同时出库同一物料就会超卖。正确做法是用SELECT ... FOR UPDATE锁住那一行再判断再更新。// Service 层出库核心逻辑Transactional 保证原子性 Transactional(rollbackFor Exception.class) public void outbound(Long materialId, Long warehouseId, int qty) { // 1. 行锁查库存锁住这条记录直到事务提交 Stock stock stockMapper.selectForUpdate(materialId, warehouseId); if (stock null) { throw new BizException(该物料在此仓库无库存记录); } // 2. 判断是否够扣 if (stock.getQuantity() qty) { throw new BizException(库存不足当前可用 stock.getQuantity()); } // 3. 扣减并写回 stock.setQuantity(stock.getQuantity() - qty); stockMapper.updateById(stock); // 4. 写出库单 outboundMapper.insert(new Outbound(materialId, warehouseId, qty)); }逻辑说明Transactional的rollbackFor Exception.class保证任何异常都回滚默认只回滚运行时异常业务异常如果不显式声明就不会回滚这是血泪经验。selectForUpdate对应的 SQL 是SELECT * FROM stock WHERE material_id? AND warehouse_id? FOR UPDATE它会在事务提交前锁住这一行第二个并发请求会阻塞等待从而避免超卖。参数上qty必须做正数校验负数出库等于变相入库是常见漏洞。这套逻辑在单机 MySQL 上够用如果将来上多实例要考虑用乐观锁版本号或分布式锁但那是后话。3.3 用 MyBatis 写增删改查mapper 与 XML 的对应关系现成源码大多用 MyBatismapper接口和 XML 文件一一对应。改功能时最容易出错的是「接口方法名和 XML 的 id 对不上」启动不报错一调用就Invalid bound statement。!-- StockMapper.xml 片段 -- mapper namespacecom.example.mapper.StockMapper !-- id 必须和接口方法名完全一致 -- select idselectForUpdate resultTypecom.example.entity.Stock SELECT * FROM stock WHERE material_id #{materialId} AND warehouse_id #{warehouseId} FOR UPDATE /select update idupdateById UPDATE stock SET quantity #{quantity} WHERE id #{id} /update /mapper逻辑说明namespace要指向接口的全限定名id要和接口方法名一字不差resultType要写实体类的全路径。#{materialId}是预编译占位符能防 SQL 注入如果写成${materialId}就是字符串拼接存在注入风险这是 web 安全里最基础的坑。改完 XML 记得重新编译IDEA 有时不会自动热加载 mapper 文件导致改了没生效白排查半天。4. 避坑与排查跑不起来、数据不对、越改越乱这一章集中讲实操里最常撞的几类问题每条按「现象 → 原因 → 解决」写。这些问题在现成源码里出现频率极高提前知道能省下大量时间。4.1 启动报错端口占用与 JDK 版本不匹配现象mvn spring-boot:run报Port 8080 was already in use或者报Unsupported class file major version 61。原因前者是本机 8080 被别的服务占了后者是项目要 JDK 17 但你用的是 JDK 861 对应 JDK 17。解决端口占用就改server.port或杀掉占用进程Windows 用netstat -ano | findstr 8080找 PID 再taskkillLinux 用lsof -i:8080。JDK 版本问题就装对应版本用java -version确认IDEA 里还要在 Project Structure 里把 SDK 和 Language Level 都改对只改一处不生效。4.2 中文乱码从数据库到页面的三层字符集现象物料名称存进去是问号或者页面显示æç©。原因字符集在数据库、连接、页面三层里有一层没设对。解决数据库层确认建库用了utf8mb4连接层在 JDBC URL 里加useUnicodetruecharacterEncodingutf8页面层确认 HTML 有meta charsetUTF-8JSP 还要在顶部加% page contentTypetext/html;charsetUTF-8 %。三层都对了才不会乱码只改一层往往还是花屏。4.3 库存对不上并发扣减与浮点累加现象盘点时库存比实际少或者出现小数尾数。原因出库逻辑没加事务和行锁并发下超卖或者数量字段用了float。解决按 3.2 的方式加Transactional和FOR UPDATE把数量字段改成int或decimal已经存了脏数据的要写脚本清洗。这个问题在演示视频里看不出来因为视频是单人操作一上真实并发就暴露。4.4 改功能后 500mapper 绑定失败与字段名不一致现象加了个查询方法启动正常一调用报Invalid bound statement (not found)。原因mapper 接口方法名和 XML 的id不一致或者 XML 没被扫描到。解决核对方法名和 id确认application.yml里mybatis.mapper-locations指向了正确的路径比如classpath:mapper/*.xml。另一个常见情况是实体类字段和数据库列名不一致resultType映射不上需要在 XML 里写resultMap或用mapUnderscoreToCamelCasetrue开启驼峰转换。4.5 连接池耗尽连接没关与池子太小现象跑一段时间后报Connection is not available, request timed out。原因手写 JDBC 代码忘了关连接或者连接池maximum-pool-size设太小。解决用 MyBatis 或 JPA 时连接由框架管理一般不会泄漏如果是手写 JDBC必须try-with-resources或 finally 里 close。池子大小按并发量估本地开发 10 够用生产环境要结合数据库最大连接数来定盲目调大反而拖垮数据库。5. 进阶把现成系统改成能用的内部工具跑通、看懂、避坑之后最后一个问题是这套东西怎么从「能演示」变成「能干活」。现成源码通常缺三样东西——操作日志、数据导出、权限细分。补上这三样它就能当小团队内部工具用。操作日志最省事的做法是用 AOP 切面在入库、出库、删除这些方法上打注解自动记录操作人、时间、参数。数据导出用 EasyExcel 或 POI把库存表导成 Excel注意大数据量要分页查再写别一次select *全捞进内存。权限细分是在user表加role字段用拦截器判断 URL 前缀比如/admin/**只允许管理员访问。// AOP 记录操作日志的切面核心 Aspect Component public class LogAspect { Around(annotation(com.example.annotation.OpLog)) public Object record(ProceedingJoinPoint pjp) throws Throwable { long start System.currentTimeMillis(); Object result pjp.proceed(); // 执行原方法 long cost System.currentTimeMillis() - start; // 记录方法名、参数、耗时、当前登录用户 logService.save(pjp.getSignature().getName(), Arrays.toString(pjp.getArgs()), cost); return result; } }逻辑说明Around环绕通知能在方法执行前后都插逻辑pjp.proceed()是真正调用原方法别忘了返回它的结果否则接口返回 null。annotation限定只拦截打了OpLog注解的方法避免日志爆炸。耗时统计对排查慢接口很有用仓库管理系统里出库和盘点查询最容易慢有了这个数据就知道该给哪张表加索引。验证改造是否成功有个简单办法开两个浏览器一个用管理员登录一个用普通操作员登录同时操作同一物料看权限拦截和库存扣减是否都正确。再导出一次库存 Excel和数据库SELECT的结果对一遍数字一致才算过关。我自己踩过最深的坑是早期图省事把库存数量直接在前端算好再提交结果网络一卡就错位后来全部改成后端事务里算再没出过账实不符。做这类系统凡是涉及数量的操作一律不信前端一律进事务这个习惯比任何框架都值钱。希望帮到你。本文还有配套的精品资源点击获取