尧图网页设计 
简介Java版WMS仓储管理系统完整源码包面向具备Java Web基础的开发者适用于仓库、物料、供应商、调拨、统计等业务场景。系统基于SpringBoot 2、Mybatis、Shiro、Vue2与MySQL 5.7搭建业务模块覆盖入库/出库、上架/下架、退货、货位库存、采购、生产、质检、通用管理及系统监控等并配套部署文档与部署视频。压缩包共2030个文件约262.43MB以Java源码、XML/Properties配置、SQL脚本、Markdown说明文档和PDF文档为主目录结构清晰便于按模块学习。已有204人学习适合用来理解WMS/MES常见流程掌握SpringBootVue的整合部署与企业级项目二次开发思路。1. 这份 Java 版 WMS 源码不是 PPT是能直接跑起来的仓库管理系统先说要害WMS仓库管理系统在中小制造企业里从来不是要不要上的问题而是怎么低成本落地的问题。市面上一套商业 WMS 动辄几十万定制周期三个月起很多工厂最后买回去的只是一堆用不上的模块。这份 Java 版 WMS 系统源码再加上配套的部署文档和部署视频解决的恰恰是「我要一套能跑、能改、能接 MES」的自有仓库系统。我拆过的源码包不少能同时满足「代码完整、部署闭环、视频不跳步」这三点的确实不多。这套资源适合四类人一是公司要做仓储数字化、想先看开源方案再决定自研还是采购的技术负责人二是正在做毕业设计或课程设计的 Java 学生需要一套规范的 SSM 或 Spring Boot 项目参考三是从 Java 基础往企业级项目过渡的开发者想找一个中等复杂度、业务逻辑清晰的源码来精读四是已经在用 Excel 管库存、想升级到系统的仓库主管可以拿这套部署在自己的服务器上先跑起来。为什么值得花时间看这篇拆解因为我会把源码结构、核心业务表设计、部署实操步骤、以及我踩过的坑全部摊开讲你照着做半天内能看到登录页面不用再去百度「WMS 源码怎么跑起来」浪费一整天。接下来直接进源码结构看看这套系统凭什么能扛住真实仓库业务。2. 源码结构拆解从 Spring Boot 入口到四大核心业务模块拿到源码包先别急着启动花十分钟把目录结构认清后面部署和二次开发都能少走弯路。我先按最常见的 Java 工程规范把它的层次讲清楚再挑几段关键代码说明白这样你改起来就知道动哪里。2.1 工程模块划分与目录导航一套规范的企业级 Java 项目不管用的是 Spring Boot 还是 SSM目录结构通常都遵循「启动类 控制层 业务层 持久层 配置资源」这套约定。这份 WMS 源码也不例外我以 Spring Boot 版本为例拆给你看如果你拿到的是 SSM 版本结构类似只是把 Spring Boot 的自动配置换成了 XML 配置。wms-parent/ ├── pom.xml // Maven 父工程统一依赖版本管理 ├── wms-common/ // 公共模块工具类、统一返回结构、分页参数 ├── wms-system/ // 系统管理模块用户、角色、菜单、权限 ├── wms-warehouse/ // 仓储业务模块入库、出库、盘点、移库 ├── wms-report/ // 报表统计模块库存流水、出入库报表 └── wms-web/ // Web 启动模块Controller、启动类、配置文件这种分层的好处不用多说你要改权限逻辑进 wms-system要调出入库的业务规则进 wms-warehouse要加一个统计图表去 wms-report 里加接口。实际业务中我带的团队做仓储项目也是这套切法按业务域而不是按技术层切模块后期多人协作分支冲突会少很多。2.2 核心业务表的设计思路与数据流仓库系统的核心是库存流水一切业务动作最终都落到库存数量的增减上。我拆过的很多烂项目就是把「库存表」当万能表所有业务直接 update 数量最后库存对不上账。这套源码我看了它的表设计走的是规范路线以库存表为结果表以流水表为过程表。表名核心字段作用说明wms_stockid, sku_id, warehouse_id, quantity实时库存余额每次业务动作后更新wms_stock_flowid, sku_id, type, quantity, before_qty, after_qty流水记录业务动作的原始凭证wms_inbound_orderorder_no, supplier_id, status入库单主表状态流转用wms_inbound_itemorder_id, sku_id, plan_qty, real_qty入库单明细实收与计划对比wms_outbound_orderorder_no, customer_id, status出库单主表发货业务wms_userid, username, role_type用户与角色关联这套表设计的精髓在 wms_stock_flow 里的 before_qty 和 after_qty 两个字段。每笔业务发生前先记录当前库存量再写入操作后的库存量这样一来可以对账、可以回溯后期做报表还能算出任意时点的库存快照。我自己的习惯是任何库存类系统都必须有这张流水账表否则出了数据差异根本没法查。2.3 关键代码走读库存扣减的并发控制逻辑出库扣库存是整个仓库系统里最容易出并发问题的地方。如果两个订单同时扣同一个 SKU 的库存不加控制就可能扣成负数。这份源码我抽了它的扣减逻辑用的是乐观锁方案代码大致长这样Transactional public boolean deductStock(String skuId, Integer warehouseId, Integer quantity) { // 1. 查出当前库存记录带版本号 Stock stock stockMapper.selectBySkuAndWarehouse(skuId, warehouseId); if (stock null || stock.getQuantity() quantity) { throw new BusinessException(库存不足当前可用库存 (stock null ? 0 : stock.getQuantity())); } // 2. 乐观锁更新compare and set版本号作为并发控制条件 int rows stockMapper.deductWithVersion(stock.getId(), quantity, stock.getVersion()); if (rows 0) { // 3. 并发冲突时抛异常由上层决定重试或提示用户 throw new BusinessException(库存更新冲突请重试); } // 4. 本次业务动作写入流水表带出扣减前的库存量 stockFlowMapper.insert(FlowTypeEnum.OUTBOUND.getCode(), skuId, quantity, stock.getQuantity(), stock.getQuantity() - quantity); return true; }对应的 Mapper SQL 用了一个带版本条件的 UPDATEUPDATE wms_stock SET quantity quantity - #{quantity}, version version 1 WHERE id #{id} AND version #{version} AND quantity #{quantity}这段代码好在哪第一事务包裹保证扣减和流水写入同生共死第二UPDATE 语句里同时带版本号和库存量条件并发下谁先提交谁成功后提交的直接影响行数为 0代码立刻感知到冲突第三流水表记录的是扣减前的数量审计有据可查。实际使用中需要注意的是乐观锁的连接池配置。如果用的是 HikariCPmaximumPoolSize 不需要设太大默认 10 就够因为库存操作事务很短连接很快释放。如果并发特别高的场景可以配合 Redis 预扣库存但这套源码没有引入 Redis说明它的定位就是中小仓库的并发量级别拿着它硬扛几千 QPS那不属于它的战场。3. 部署实操照着部署视频走两小时看到登录页部署文档和部署视频是这份资源的硬通货我按自己的部署习惯把流程捋一遍你在服务器上操作时直接对照。无论是 Linux 还是 Windows核心三步装环境、改配置、启动验证。3.1 环境准备清单与版本兼容建议先把环境列个清单我踩过的版本坑后面单独讲。这套源码基于 Java 生态环境要求不算苛刻但版本别乱配尤其是 Java 和 MySQL 的搭配。软件推荐版本备选版本关键说明JDK1.811Spring Boot 2.x 用 1.8 最稳别上 17Maven3.6.33.8.x3.9 以上对部分私有仓库有兼容问题MySQL5.78.05.7 最稳8.0 需要改驱动配置Redis非必需-如果源码版本没集成不用装Nginx1.20任意前后端分离版本用一体化打包含内置容器确认环境最省事的命令是这三条java -version mvn -v mysql --version三行都正常输出且版本符合要求就可以进入下一步。我在给客户交付时环境准备这一关就能筛掉一半部署失败的情况多花两分钟确认比启动报错再回头排查快得多。3.2 数据库初始化与配置调整接下来建库导数据。源码包里一般会带 database/sql 目录里面是建表语句和初始数据脚本可能的文件有wms.sql、wms_init_data.sql。mysql -uroot -p // 建库注意字符集别小看这一步 CREATE DATABASE wms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE wms; // 导入表结构和初始数据 SOURCE /root/wms/sql/wms.sql SOURCE /root/wms/sql/wms_init_data.sql建库用 utf8mb4 是硬规矩因为仓库物料描述里可能有生僻字、特殊符号utf8 的 3 字节限制会报 Incorrect string value 错误。我当年被这个坑过导入数据一半失败查了半天才发现建库时偷懒用了默认字符集。然后改工程配置Spring Boot 项目在wms-web/src/main/resources/application.yml下server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/wms?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_strong_password driver-class-name: com.mysql.jdbc.Driver数据库密码此时不换等什么时候换。部署文档里大概率写的是 root/123456你连接失败时先检查这里有没有遗漏。时区参数 serverTimezone 必须带上否则 MySQL 8 下日期字段会差 8 小时到跑报表时发现时间对不上来回查浪费半天。如果你的 MySQL 是 8.0需要把驱动改成com.mysql.cj.jdbc.Driver并且 URL 保持不变这是 MySQL 官方在新版本里换的驱动包名。3.3 Maven 打包与进程启动验证工程确认无改动后先本地打包。Maven 打包这一步网络差的机器可能要下载一堆依赖建议配国内镜像源再操作。# 进入工程根目录执行 clean 和 package跳过测试 mvn clean package -DskipTests -Pprod打包成功会生成wms-web/target/wms-web-1.0.0.jar接下来就是启动。我通常用 nohup 放后台跑挂断终端不影响进程nohup java -jar wms-web/target/wms-web-1.0.0.jar --server.port8080 logs/wms.log 21 启动过程中边看日志边验证状态这是排查问题的关键手法# 实时看启动日志 tail -f logs/wms.log # 等出现 Started 关键字后验证端口 netstat -npl | grep 8080 # 直接验证登录接口 curl -X POST http://localhost:8080/api/login -H Content-Type: application/json -d {username:admin,password:admin123}看到 curling 返回 token 或用户信息部署就算跑通了。在这个阶段我强烈建议你跟着部署视频走一遍每一个界面操作视频里往往包含 Windows 本地的 IDEA 启动演示和 Linux 服务器实操是互补的两边都看能减少很多环境差异带来的问题。3.4 前后端分离版Nginx 静态资源代理提示如果你拿到的源码是前后端分离版wms-web可能只提供 API页面是独立的 dist 目录此时前端静态文件要配 Nginx 做代理。我一般会给客户这样一份最小代理配置server { listen 80; server_name yourdomain.com; # 前端页面 root /opt/wms/dist; index index.html; # API 反向代理 location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } # 解决前端历史路由刷新 404 location / { try_files $uri $uri/ /index.html; } }这个配置里有三处要点前端用 history 路由时 try_files 必须有API 代理路径要匹配后端 server.servlet.context-path静态文件权限要确保 nginx 用户能读取否则页面出来全是白屏加 403。实战中我遇到最多的前端问题就是这第三个——文件放在 root 家目录下权限默认 700Nginx 读不了。4. 部署避坑实录五次翻车换来的五条排查经验这块拿出来单独讲是因为部署 WMS 这类系统环境问题远多于代码问题。我把拆这套源码过程中真实遇到过的坑整理成清单每一条都是「现象 → 原因 → 解决」的三段式你照着排能省下来回折腾的功夫。4.1 启动直接报 ClassNotFoundException 或 NoClassDefFoundError现象java -jar执行时报java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter之类的错误日志堆栈显示类找不到。原因JDK 版本高于 1.8高版本 JDK 把 JAXB 相关的包从标准库剥除了。这套 WMS 源码里如果有老式 XML 解析依赖就会中招。部署文档写 JDK 1.8 却没用 1.8 跑的第一锅这里背。解决严格切换到 JDK 1.8 启动先执行java -version确认版本。如果机器上装了多版本 JDK启动时显式指路径比如/usr/local/jdk1.8.0_202/bin/java -jar wms-web.jar。非要用 JDK 11 的话就得加--add-modules java.xml.bind这类参数麻烦不推荐。4.2 MySQL 连接报 Communications link failure现象启动日志报Communications link failure或者Access denied for user rootlocalhost。原因八成不是网络不通而是账号密码错了或者 MySQL 默认 root 只允许 localhost 登录。docker 容器里部署时容器 IP 和宿主机 localhost 根本不是一回事。解决先确认账号密码能手动连库mysql -uroot -p -h 127.0.0.1 -P 3306能连上那问题就在 application.yml 的 URL 里 host 写错了。如果是 docker 里的 MySQL建议不要把 root 暴露出去而是建普通用户CREATE USER wms_user% IDENTIFIED BY Wms2024;再授权给 wms 库改配置文件用这个账号安全又省心。4.3 页面能打开但验证码不显示或登录后菜单空白现象登录页出来了验证码图片刷不出来或者登录进去左侧菜单一条都没有。原因验证码接口或菜单接口 404通常是后端 context-path 和前端请求的路径对不上。前端请求/api/captcha后端却跑在/wms下代理没做重叠就把路径丢了。解决浏览器按 F12 打开 Network 面板看接口实际请求 URL 和后端日志的访问路径两者必须一致。要快速定位直接 curl 后端接口地址看返回比如curl http://localhost:8080/api/captcha有 Response body 没报错就说明后端没问题前端改环境变量里的 baseURL 即可。4.4 导入 SQL 时外键约束报错现象SOURCE wms.sql执行到中途报Cannot add foreign key constraint。原因常见的两种情况一是表创建顺序不对子表先于父表创建二是字符集或存储引擎不一致两张表的 ENGINE 或 CHARSET 不同会导致 InnoDB 拒绝建约束。解决优先检查 MySQL 的default-storage-engine是否统一为 InnoDB。在导入前先执行一句SET FOREIGN_KEY_CHECKS 0;导完再设回 1。这个开关是临时绕行根治办法是统一字符集配置default_character_setutf8mb4确保每张表都是 InnoDB 引擎。还有一个小技巧sql 文件里如果开头没有SET NAMES utf8mb4你可以在命令行加上--default-character-setutf8mb4再导入。4.5 Linux 服务器部署时图片或文件上传失败现象系统里传图片、传附件一直转圈或报 500但本地 IDEA 启动是好的。原因Linux 写文件权限不足。jar 包启动时当前用户可能是 root也可能是个普通用户而上传目录通常配置为upload.path/opt/wms/files或类似路径要么不存在要么没有写权限。Windows 下不需要考虑这个问题所以本地测不出来。解决确认上传目录存在并归启动用户所有然后递归授权mkdir -p /opt/wms/files chown -R root:root /opt/wms/files chmod -R 755 /opt/wms/files如果你是拿普通用户跑的 jar就把 root:root 换成对应的用户名。这个坑在真实交付中出现频率极高客户反馈「不能传图」十有八九是权限问题而不是代码问题。5. 验证系统是否完整落地用业务闭环测试替代目录检查源码到手、服务能跑只是第一步真正确认这套系统「能用」还得用业务用户的视角走一遍完整的仓库收发流程。我每次拆完项目给团队交接都会用同样的方法验证一遍——只点菜单看不出毛病跑一遍真实业务链路才知道代码有没有硬伤。整条链路测完基本可以确认系统达到真实可用水平。这套源码我推荐在测试环境多跑几轮循环业务把不常见的策略触发条件都过一遍比如负库存拦截、盘点差异处理。用测试数据压它也好过上线后被真实库存数据教育。最后说点我自己的毛病每次部署这类带视频的源码项目我永远先看视频里前五分钟的环境检查而不是直接跳到最后启动。这个习惯救过我很多次——视频里演示者用的是 JDK 8你本地装着 17 直接就崩重新走一遍才发现开头就说了版本要求。从那以后我每次拿到新的 WMS 或 MES 这类企业级工程都强制自己先按文档清单核对环境版本再执行启动命令省下的全是排查时间。如果你想跳过这些坑直接看系统跑起来的样子部署文档和部署视频就是为这个排错的照着视频走完一遍再回来改代码会顺手很多。希望帮到你动手去部署吧。本文还有配套的精品资源点击获取 Java版WMS仓库管理系统源码解析与部署实战指南
简介Java版WMS仓储管理系统完整源码包面向具备Java Web基础的开发者适用于仓库、物料、供应商、调拨、统计等业务场景。系统基于SpringBoot 2、Mybatis、Shiro、Vue2与MySQL 5.7搭建业务模块覆盖入库/出库、上架/下架、退货、货位库存、采购、生产、质检、通用管理及系统监控等并配套部署文档与部署视频。压缩包共2030个文件约262.43MB以Java源码、XML/Properties配置、SQL脚本、Markdown说明文档和PDF文档为主目录结构清晰便于按模块学习。已有204人学习适合用来理解WMS/MES常见流程掌握SpringBootVue的整合部署与企业级项目二次开发思路。1. 这份 Java 版 WMS 源码不是 PPT是能直接跑起来的仓库管理系统先说要害WMS仓库管理系统在中小制造企业里从来不是要不要上的问题而是怎么低成本落地的问题。市面上一套商业 WMS 动辄几十万定制周期三个月起很多工厂最后买回去的只是一堆用不上的模块。这份 Java 版 WMS 系统源码再加上配套的部署文档和部署视频解决的恰恰是「我要一套能跑、能改、能接 MES」的自有仓库系统。我拆过的源码包不少能同时满足「代码完整、部署闭环、视频不跳步」这三点的确实不多。这套资源适合四类人一是公司要做仓储数字化、想先看开源方案再决定自研还是采购的技术负责人二是正在做毕业设计或课程设计的 Java 学生需要一套规范的 SSM 或 Spring Boot 项目参考三是从 Java 基础往企业级项目过渡的开发者想找一个中等复杂度、业务逻辑清晰的源码来精读四是已经在用 Excel 管库存、想升级到系统的仓库主管可以拿这套部署在自己的服务器上先跑起来。为什么值得花时间看这篇拆解因为我会把源码结构、核心业务表设计、部署实操步骤、以及我踩过的坑全部摊开讲你照着做半天内能看到登录页面不用再去百度「WMS 源码怎么跑起来」浪费一整天。接下来直接进源码结构看看这套系统凭什么能扛住真实仓库业务。2. 源码结构拆解从 Spring Boot 入口到四大核心业务模块拿到源码包先别急着启动花十分钟把目录结构认清后面部署和二次开发都能少走弯路。我先按最常见的 Java 工程规范把它的层次讲清楚再挑几段关键代码说明白这样你改起来就知道动哪里。2.1 工程模块划分与目录导航一套规范的企业级 Java 项目不管用的是 Spring Boot 还是 SSM目录结构通常都遵循「启动类 控制层 业务层 持久层 配置资源」这套约定。这份 WMS 源码也不例外我以 Spring Boot 版本为例拆给你看如果你拿到的是 SSM 版本结构类似只是把 Spring Boot 的自动配置换成了 XML 配置。wms-parent/ ├── pom.xml // Maven 父工程统一依赖版本管理 ├── wms-common/ // 公共模块工具类、统一返回结构、分页参数 ├── wms-system/ // 系统管理模块用户、角色、菜单、权限 ├── wms-warehouse/ // 仓储业务模块入库、出库、盘点、移库 ├── wms-report/ // 报表统计模块库存流水、出入库报表 └── wms-web/ // Web 启动模块Controller、启动类、配置文件这种分层的好处不用多说你要改权限逻辑进 wms-system要调出入库的业务规则进 wms-warehouse要加一个统计图表去 wms-report 里加接口。实际业务中我带的团队做仓储项目也是这套切法按业务域而不是按技术层切模块后期多人协作分支冲突会少很多。2.2 核心业务表的设计思路与数据流仓库系统的核心是库存流水一切业务动作最终都落到库存数量的增减上。我拆过的很多烂项目就是把「库存表」当万能表所有业务直接 update 数量最后库存对不上账。这套源码我看了它的表设计走的是规范路线以库存表为结果表以流水表为过程表。表名核心字段作用说明wms_stockid, sku_id, warehouse_id, quantity实时库存余额每次业务动作后更新wms_stock_flowid, sku_id, type, quantity, before_qty, after_qty流水记录业务动作的原始凭证wms_inbound_orderorder_no, supplier_id, status入库单主表状态流转用wms_inbound_itemorder_id, sku_id, plan_qty, real_qty入库单明细实收与计划对比wms_outbound_orderorder_no, customer_id, status出库单主表发货业务wms_userid, username, role_type用户与角色关联这套表设计的精髓在 wms_stock_flow 里的 before_qty 和 after_qty 两个字段。每笔业务发生前先记录当前库存量再写入操作后的库存量这样一来可以对账、可以回溯后期做报表还能算出任意时点的库存快照。我自己的习惯是任何库存类系统都必须有这张流水账表否则出了数据差异根本没法查。2.3 关键代码走读库存扣减的并发控制逻辑出库扣库存是整个仓库系统里最容易出并发问题的地方。如果两个订单同时扣同一个 SKU 的库存不加控制就可能扣成负数。这份源码我抽了它的扣减逻辑用的是乐观锁方案代码大致长这样Transactional public boolean deductStock(String skuId, Integer warehouseId, Integer quantity) { // 1. 查出当前库存记录带版本号 Stock stock stockMapper.selectBySkuAndWarehouse(skuId, warehouseId); if (stock null || stock.getQuantity() quantity) { throw new BusinessException(库存不足当前可用库存 (stock null ? 0 : stock.getQuantity())); } // 2. 乐观锁更新compare and set版本号作为并发控制条件 int rows stockMapper.deductWithVersion(stock.getId(), quantity, stock.getVersion()); if (rows 0) { // 3. 并发冲突时抛异常由上层决定重试或提示用户 throw new BusinessException(库存更新冲突请重试); } // 4. 本次业务动作写入流水表带出扣减前的库存量 stockFlowMapper.insert(FlowTypeEnum.OUTBOUND.getCode(), skuId, quantity, stock.getQuantity(), stock.getQuantity() - quantity); return true; }对应的 Mapper SQL 用了一个带版本条件的 UPDATEUPDATE wms_stock SET quantity quantity - #{quantity}, version version 1 WHERE id #{id} AND version #{version} AND quantity #{quantity}这段代码好在哪第一事务包裹保证扣减和流水写入同生共死第二UPDATE 语句里同时带版本号和库存量条件并发下谁先提交谁成功后提交的直接影响行数为 0代码立刻感知到冲突第三流水表记录的是扣减前的数量审计有据可查。实际使用中需要注意的是乐观锁的连接池配置。如果用的是 HikariCPmaximumPoolSize 不需要设太大默认 10 就够因为库存操作事务很短连接很快释放。如果并发特别高的场景可以配合 Redis 预扣库存但这套源码没有引入 Redis说明它的定位就是中小仓库的并发量级别拿着它硬扛几千 QPS那不属于它的战场。3. 部署实操照着部署视频走两小时看到登录页部署文档和部署视频是这份资源的硬通货我按自己的部署习惯把流程捋一遍你在服务器上操作时直接对照。无论是 Linux 还是 Windows核心三步装环境、改配置、启动验证。3.1 环境准备清单与版本兼容建议先把环境列个清单我踩过的版本坑后面单独讲。这套源码基于 Java 生态环境要求不算苛刻但版本别乱配尤其是 Java 和 MySQL 的搭配。软件推荐版本备选版本关键说明JDK1.811Spring Boot 2.x 用 1.8 最稳别上 17Maven3.6.33.8.x3.9 以上对部分私有仓库有兼容问题MySQL5.78.05.7 最稳8.0 需要改驱动配置Redis非必需-如果源码版本没集成不用装Nginx1.20任意前后端分离版本用一体化打包含内置容器确认环境最省事的命令是这三条java -version mvn -v mysql --version三行都正常输出且版本符合要求就可以进入下一步。我在给客户交付时环境准备这一关就能筛掉一半部署失败的情况多花两分钟确认比启动报错再回头排查快得多。3.2 数据库初始化与配置调整接下来建库导数据。源码包里一般会带 database/sql 目录里面是建表语句和初始数据脚本可能的文件有wms.sql、wms_init_data.sql。mysql -uroot -p // 建库注意字符集别小看这一步 CREATE DATABASE wms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE wms; // 导入表结构和初始数据 SOURCE /root/wms/sql/wms.sql SOURCE /root/wms/sql/wms_init_data.sql建库用 utf8mb4 是硬规矩因为仓库物料描述里可能有生僻字、特殊符号utf8 的 3 字节限制会报 Incorrect string value 错误。我当年被这个坑过导入数据一半失败查了半天才发现建库时偷懒用了默认字符集。然后改工程配置Spring Boot 项目在wms-web/src/main/resources/application.yml下server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/wms?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_strong_password driver-class-name: com.mysql.jdbc.Driver数据库密码此时不换等什么时候换。部署文档里大概率写的是 root/123456你连接失败时先检查这里有没有遗漏。时区参数 serverTimezone 必须带上否则 MySQL 8 下日期字段会差 8 小时到跑报表时发现时间对不上来回查浪费半天。如果你的 MySQL 是 8.0需要把驱动改成com.mysql.cj.jdbc.Driver并且 URL 保持不变这是 MySQL 官方在新版本里换的驱动包名。3.3 Maven 打包与进程启动验证工程确认无改动后先本地打包。Maven 打包这一步网络差的机器可能要下载一堆依赖建议配国内镜像源再操作。# 进入工程根目录执行 clean 和 package跳过测试 mvn clean package -DskipTests -Pprod打包成功会生成wms-web/target/wms-web-1.0.0.jar接下来就是启动。我通常用 nohup 放后台跑挂断终端不影响进程nohup java -jar wms-web/target/wms-web-1.0.0.jar --server.port8080 logs/wms.log 21 启动过程中边看日志边验证状态这是排查问题的关键手法# 实时看启动日志 tail -f logs/wms.log # 等出现 Started 关键字后验证端口 netstat -npl | grep 8080 # 直接验证登录接口 curl -X POST http://localhost:8080/api/login -H Content-Type: application/json -d {username:admin,password:admin123}看到 curling 返回 token 或用户信息部署就算跑通了。在这个阶段我强烈建议你跟着部署视频走一遍每一个界面操作视频里往往包含 Windows 本地的 IDEA 启动演示和 Linux 服务器实操是互补的两边都看能减少很多环境差异带来的问题。3.4 前后端分离版Nginx 静态资源代理提示如果你拿到的源码是前后端分离版wms-web可能只提供 API页面是独立的 dist 目录此时前端静态文件要配 Nginx 做代理。我一般会给客户这样一份最小代理配置server { listen 80; server_name yourdomain.com; # 前端页面 root /opt/wms/dist; index index.html; # API 反向代理 location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } # 解决前端历史路由刷新 404 location / { try_files $uri $uri/ /index.html; } }这个配置里有三处要点前端用 history 路由时 try_files 必须有API 代理路径要匹配后端 server.servlet.context-path静态文件权限要确保 nginx 用户能读取否则页面出来全是白屏加 403。实战中我遇到最多的前端问题就是这第三个——文件放在 root 家目录下权限默认 700Nginx 读不了。4. 部署避坑实录五次翻车换来的五条排查经验这块拿出来单独讲是因为部署 WMS 这类系统环境问题远多于代码问题。我把拆这套源码过程中真实遇到过的坑整理成清单每一条都是「现象 → 原因 → 解决」的三段式你照着排能省下来回折腾的功夫。4.1 启动直接报 ClassNotFoundException 或 NoClassDefFoundError现象java -jar执行时报java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter之类的错误日志堆栈显示类找不到。原因JDK 版本高于 1.8高版本 JDK 把 JAXB 相关的包从标准库剥除了。这套 WMS 源码里如果有老式 XML 解析依赖就会中招。部署文档写 JDK 1.8 却没用 1.8 跑的第一锅这里背。解决严格切换到 JDK 1.8 启动先执行java -version确认版本。如果机器上装了多版本 JDK启动时显式指路径比如/usr/local/jdk1.8.0_202/bin/java -jar wms-web.jar。非要用 JDK 11 的话就得加--add-modules java.xml.bind这类参数麻烦不推荐。4.2 MySQL 连接报 Communications link failure现象启动日志报Communications link failure或者Access denied for user rootlocalhost。原因八成不是网络不通而是账号密码错了或者 MySQL 默认 root 只允许 localhost 登录。docker 容器里部署时容器 IP 和宿主机 localhost 根本不是一回事。解决先确认账号密码能手动连库mysql -uroot -p -h 127.0.0.1 -P 3306能连上那问题就在 application.yml 的 URL 里 host 写错了。如果是 docker 里的 MySQL建议不要把 root 暴露出去而是建普通用户CREATE USER wms_user% IDENTIFIED BY Wms2024;再授权给 wms 库改配置文件用这个账号安全又省心。4.3 页面能打开但验证码不显示或登录后菜单空白现象登录页出来了验证码图片刷不出来或者登录进去左侧菜单一条都没有。原因验证码接口或菜单接口 404通常是后端 context-path 和前端请求的路径对不上。前端请求/api/captcha后端却跑在/wms下代理没做重叠就把路径丢了。解决浏览器按 F12 打开 Network 面板看接口实际请求 URL 和后端日志的访问路径两者必须一致。要快速定位直接 curl 后端接口地址看返回比如curl http://localhost:8080/api/captcha有 Response body 没报错就说明后端没问题前端改环境变量里的 baseURL 即可。4.4 导入 SQL 时外键约束报错现象SOURCE wms.sql执行到中途报Cannot add foreign key constraint。原因常见的两种情况一是表创建顺序不对子表先于父表创建二是字符集或存储引擎不一致两张表的 ENGINE 或 CHARSET 不同会导致 InnoDB 拒绝建约束。解决优先检查 MySQL 的default-storage-engine是否统一为 InnoDB。在导入前先执行一句SET FOREIGN_KEY_CHECKS 0;导完再设回 1。这个开关是临时绕行根治办法是统一字符集配置default_character_setutf8mb4确保每张表都是 InnoDB 引擎。还有一个小技巧sql 文件里如果开头没有SET NAMES utf8mb4你可以在命令行加上--default-character-setutf8mb4再导入。4.5 Linux 服务器部署时图片或文件上传失败现象系统里传图片、传附件一直转圈或报 500但本地 IDEA 启动是好的。原因Linux 写文件权限不足。jar 包启动时当前用户可能是 root也可能是个普通用户而上传目录通常配置为upload.path/opt/wms/files或类似路径要么不存在要么没有写权限。Windows 下不需要考虑这个问题所以本地测不出来。解决确认上传目录存在并归启动用户所有然后递归授权mkdir -p /opt/wms/files chown -R root:root /opt/wms/files chmod -R 755 /opt/wms/files如果你是拿普通用户跑的 jar就把 root:root 换成对应的用户名。这个坑在真实交付中出现频率极高客户反馈「不能传图」十有八九是权限问题而不是代码问题。5. 验证系统是否完整落地用业务闭环测试替代目录检查源码到手、服务能跑只是第一步真正确认这套系统「能用」还得用业务用户的视角走一遍完整的仓库收发流程。我每次拆完项目给团队交接都会用同样的方法验证一遍——只点菜单看不出毛病跑一遍真实业务链路才知道代码有没有硬伤。整条链路测完基本可以确认系统达到真实可用水平。这套源码我推荐在测试环境多跑几轮循环业务把不常见的策略触发条件都过一遍比如负库存拦截、盘点差异处理。用测试数据压它也好过上线后被真实库存数据教育。最后说点我自己的毛病每次部署这类带视频的源码项目我永远先看视频里前五分钟的环境检查而不是直接跳到最后启动。这个习惯救过我很多次——视频里演示者用的是 JDK 8你本地装着 17 直接就崩重新走一遍才发现开头就说了版本要求。从那以后我每次拿到新的 WMS 或 MES 这类企业级工程都强制自己先按文档清单核对环境版本再执行启动命令省下的全是排查时间。如果你想跳过这些坑直接看系统跑起来的样子部署文档和部署视频就是为这个排错的照着视频走完一遍再回来改代码会顺手很多。希望帮到你动手去部署吧。本文还有配套的精品资源点击获取