拓冰网站定制 
简介这份基于Java的MES生产管理系统源码面向计算机相关专业的毕业设计学生、Java学习者以及希望了解制造执行系统架构的开发者。MES用于实时监控、控制和优化工厂生产流程源码覆盖生产计划管理、物料需求计划、车间控制、质量管理、人员与设备管理、数据采集及报表分析等核心模块适合作为完整项目案例进行研读与二次开发。压缩包共1140个文件约8.02MB以396个java源文件为主体配合268个js脚本、120个jsp页面及css、json、xml等配置与前端资源另有少量sql、properties文件整体结构清晰便于按模块检索。目前已有1431人学习下载。通过阅读这套源码读者可以理解Spring Boot、MyBatis等框架在MES中的落地方式掌握前后端分离与数据库设计的实践思路并在此基础上完成毕业设计或提升企业级Java开发能力。1. 从一份 Java MES 源码包说起它到底能跑通什么如果你正在做制造业信息化方向的毕业设计或者公司接了个中小型工厂的数字化改造单子大概率会遇到一个绕不开的词——MES。制造执行系统夹在 ERP 和车间设备之间管的是工单下发、工序流转、物料追溯、质量记录这些落地的活。市面上成熟的商业 MES 动辄几十万起步对预算有限的团队来说一份结构完整、能跑起来的 Java 源码包就是很好的起点。这份基于 Java 的 MES 生产管理系统源码核心价值在于把工单—工序—报工—质检—库存这条主线用可运行的代码串了起来。它不是那种只有登录页和几个空壳菜单的演示项目而是带了实体建模、权限控制、基础数据维护和业务流转逻辑的完整工程。适合三类人一是需要拿真实项目练手的 Java 学习者二是要做课程设计或毕业设计的学生三是想快速搭一个内部原型给老板看效果的小团队。下面我从技术栈拆解、环境搭建、核心模块实现到踩坑排查一步步说清楚怎么把它用起来。2. 技术栈拆解与环境搭建从 JDK 到数据库的完整链路2.1 先看清这套源码的技术底座拿到一个 Java 源码包第一件事不是急着导入 IDE而是先翻配置文件搞清楚它依赖什么。常见做法是打开pom.xmlMaven 项目或build.gradle看 Spring Boot 版本、持久层框架、数据库驱动和前端方案。这套 MES 源码的典型技术组合是Spring Boot 做基础框架MyBatis 或 MyBatis-Plus 做数据访问MySQL 存业务数据Redis 缓存会话和字典前端可能是 Thymeleaf 模板或者前后端分离的 Vue 工程。为什么这个组合值得关注因为 MES 的业务特点是读多写少但写操作要求强一致——工单状态变更、库存扣减、报工数量累加这些操作不能出现并发覆盖。MyBatis-Plus 提供的乐观锁和条件更新能覆盖大部分场景而 Spring Boot 的声明式事务让报工扣料更新工单进度能放在一个事务里。如果你之前只写过单体 CRUD这套源码能让你看到业务系统里事务边界是怎么划的。选型上还有一个容易被忽略的点JDK 版本。Spring Boot 2.x 通常配 JDK 8 或 11Spring Boot 3.x 要求 JDK 17 起步。源码里如果用了javax.*包名那就是 Spring Boot 2.x 体系如果看到jakarta.*说明是 3.x。这个判断直接决定你本地装哪个 JDK装错了连编译都过不去。2.2 环境搭建的实操步骤假设你本地是 Windows 或 macOS下面这套流程能覆盖 90% 的情况。先确认 JDK 装好并配了环境变量# 检查 JDK 版本输出应为 1.8.x 或 11.x 或 17.x java -version javac -version # 检查 Maven 是否可用 mvn -v如果java -version报不是内部或外部命令说明环境变量没配好。Windows 下需要把 JDK 的bin目录加到Path里macOS 或 Linux 下检查~/.bash_profile或~/.zshrc里的JAVA_HOME和PATH。这一步是新手翻车最多的地方别跳过。接下来建数据库。源码包里一般有个sql目录或者doc目录里面放着建表语句和初始数据-- 创建数据库字符集用 utf8mb4 避免中文乱码 CREATE DATABASE mes_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 导入建表脚本在命令行执行路径按实际调整 -- mysql -u root -p mes_db /path/to/mes_db.sql导入完成后去改application.yml或application.properties里的数据库连接spring: datasource: url: jdbc:mysql://localhost:3306/mes_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver这里有几个参数值得说清楚。serverTimezoneAsia/Shanghai不加的话MySQL 8.x 驱动会报时区错误characterEncodingutf8配合数据库的utf8mb4能避免工单备注里的中文变成问号。Redis 的配置同理如果源码里用了 Redis 做缓存记得本地启动 Redis 服务或者把缓存配置改成none先跑通主流程。最后启动项目# 在项目根目录执行跳过测试可以加快首次启动 mvn clean package -DskipTests # 运行打好的 jar 包 java -jar target/mes-*.jar # 或者直接用 Maven 插件启动 mvn spring-boot:run启动日志里看到Started Application in x.x seconds就说明服务起来了。浏览器访问http://localhost:8080默认账号密码通常在sql脚本的sys_user表里或者 README 里有说明。提示如果启动时报Table mes_db.xxx doesnt exist八成是建表脚本没导全检查sql目录下是不是有多个文件需要按顺序执行。3. 核心业务模块怎么读工单、工序与报工的数据流3.1 工单模块的实体关系与状态机MES 的心脏是工单。一份工单从创建到完工中间要经过待排产→已排产→生产中→待质检→已完工这几个状态。源码里通常用一张mes_work_order主表加一张mes_work_order_process工序明细表来实现。主表存工单号、产品、计划数量、优先级、状态明细表存每道工序的序号、名称、设备、计划工时、实际工时。读这块代码时重点看状态字段的类型和流转逻辑。常见做法是用Integer或String存状态码然后在 Service 层写一个updateStatus方法里面用if-else或状态机模式控制合法流转。比如已完工的工单不能再改回生产中这种校验如果漏了后面库存和报表全乱。// 工单状态流转的典型校验逻辑 public void updateWorkOrderStatus(Long orderId, WorkOrderStatus targetStatus) { WorkOrder order workOrderMapper.selectById(orderId); if (order null) { throw new BusinessException(工单不存在); } // 已完工的工单不允许再变更状态 if (WorkOrderStatus.COMPLETED.equals(order.getStatus())) { throw new BusinessException(工单已完工不可修改); } // 只有待排产状态才能排产 if (WorkOrderStatus.PENDING.equals(order.getStatus()) !WorkOrderStatus.SCHEDULED.equals(targetStatus)) { throw new BusinessException(待排产工单只能流转为已排产); } order.setStatus(targetStatus); workOrderMapper.updateById(order); }这段代码的逻辑说明先查工单是否存在再判断当前状态是否允许目标流转最后更新。参数orderId是工单主键targetStatus是目标状态枚举。实际项目里我会把状态流转规则抽成一张配置表或者用状态机框架因为硬编码的if-else在工序增加到十几道之后会变得很难维护。3.2 报工与库存扣减的事务边界报工是车间操作工最常用的功能扫工单条码输入完成数量、合格数量、不合格数量提交。这个动作背后至少涉及三张表的写操作——报工记录表插入一条、工单进度表更新已完成数量、库存表扣减原材料。这三步必须在一个事务里否则报工成功了但库存没扣月底盘点就对不上。Transactional(rollbackFor Exception.class) public void reportWork(ReportWorkDTO dto) { // 1. 插入报工记录 MesReport record new MesReport(); record.setOrderId(dto.getOrderId()); record.setProcessId(dto.getProcessId()); record.setFinishQty(dto.getFinishQty()); record.setQualifiedQty(dto.getQualifiedQty()); record.setUnqualifiedQty(dto.getUnqualifiedQty()); reportMapper.insert(record); // 2. 更新工单工序的已完成数量乐观锁防并发 int updated processMapper.increaseFinishQty( dto.getProcessId(), dto.getFinishQty(), dto.getVersion()); if (updated 0) { throw new BusinessException(报工冲突请刷新后重试); } // 3. 按BOM扣减原材料库存 ListMaterialConsume consumes bomService.calcMaterialConsume( dto.getOrderId(), dto.getFinishQty()); for (MaterialConsume mc : consumes) { int rows stockMapper.deductStock(mc.getMaterialId(), mc.getQty()); if (rows 0) { throw new BusinessException(库存不足 mc.getMaterialName()); } } }逻辑说明Transactional注解保证方法内所有数据库操作要么全成功要么全回滚。第二步用了乐观锁——increaseFinishQty的 SQL 里带version条件如果两个操作工同时报工只有一个能更新成功另一个会拿到updated0然后抛异常提示重试。第三步按 BOM 展开物料需求逐个扣减库存任何一个物料不够就整体回滚。参数方面dto.getFinishQty()是本次报工数量dto.getVersion()是前端传回来的版本号。这里有个容易踩的坑如果前端没把 version 传回来乐观锁就失效了。常见做法是在查询工序详情时把 version 一起返回给前端提交时原样带回。3.3 权限控制与行级数据隔离MES 系统里不同角色的可见范围差别很大。车间主任能看到所有工单普通操作工只能看到自己工位的任务质检员只能看待检工单。源码里如果用了若依框架或者类似的权限体系通常是通过PreAuthorize注解加角色来判断菜单和按钮权限。但行级权限——也就是同一个页面不同人看到不同数据——需要额外处理。常见做法是在 Mapper 的查询条件里动态拼入当前用户的部门或工位 ID!-- MyBatis XML 中的行级权限过滤 -- select idselectWorkOrderList resultTypeWorkOrderVO SELECT * FROM mes_work_order WHERE 11 if testuserId ! null and !isAdmin AND workshop_id IN ( SELECT workshop_id FROM sys_user_workshop WHERE user_id #{userId} ) /if if teststatus ! null AND status #{status} /if ORDER BY priority DESC, create_time ASC /select这段 SQL 的意思是非管理员用户只能看到自己所属车间的工单。sys_user_workshop是一张用户和车间的关联表。参数isAdmin由 Service 层根据当前登录用户的角色传入。这种写法比在 Java 代码里过滤要高效因为过滤发生在数据库层减少了数据传输量。注意行级权限的关联表如果没建索引工单量上万之后查询会明显变慢。建议在sys_user_workshop的user_id和workshop_id上分别建索引。4. 避坑与排查源码跑不起来时先查这五处4.1 启动报数据库连接失败现象启动日志里出现Communications link failure或Access denied for user。原因通常是数据库没启动、端口不对、用户名密码错或者 MySQL 8.x 的驱动类名写成了旧版的com.mysql.jdbc.Driver。解决办法先确认 MySQL 服务在运行然后用命令行mysql -u root -p能登进去再检查application.yml里的 URL 端口是不是 3306、驱动类是不是com.mysql.cj.jdbc.Driver。4.2 页面能打开但菜单全是空白现象登录成功左侧菜单树渲染出来了但点进去每个页面都是空白或者 404。原因一般是前端静态资源路径不对或者后端接口返回了 403。先按 F12 看 Network 面板如果接口返回 403说明当前账号的角色没分配对应的菜单权限如果返回 404检查 Controller 的RequestMapping路径和前端请求路径是否一致。解决办法去sys_role_menu表里给当前角色补上菜单关联或者直接用管理员账号登录验证功能是否正常。4.3 报工提交后库存没变化现象报工记录插入成功了工单进度也更新了但库存表的数据纹丝不动。原因通常是 BOM 配置为空——工单关联的产品没有维护物料清单calcMaterialConsume返回了空列表循环体没执行。解决办法检查mes_bom表里有没有该产品的物料明细如果没有就补上。另一个可能是库存扣减的 SQL 条件没匹配到记录比如物料 ID 传错了。4.4 中文乱码从数据库到页面一路飘红现象工单备注、产品名称里的中文在页面上显示成???或者乱码方块。原因链条比较长数据库字符集不是utf8mb4、连接 URL 没加characterEncodingutf8、前端页面没声明 UTF-8、Tomcat 的server.xml没配URIEncoding。解决办法从数据库建库语句开始逐层排查建库时用utf8mb4连接串加编码参数前端 HTML 的meta charsetUTF-8确认存在。如果是 Spring Boot 内嵌 Tomcat一般不用改server.xml但要在application.yml里加server.servlet.encoding.charsetUTF-8。4.5 并发报工时数据对不上现象两个操作工同时提交同一道工序的报工结果已完成数量只加了其中一个人的量另一个人的报工记录插入了但进度没更新。原因就是前面说的乐观锁失效——前端没传 version 或者 SQL 里没带 version 条件。解决办法检查increaseFinishQty的 SQL 是否包含AND version #{version}以及前端提交时有没有把查询到的 version 带回来。如果业务上不允许重试可以改成悲观锁SELECT ... FOR UPDATE但会牺牲并发性能。5. 从跑通到改顺二次开发与数据一致性验证技巧把源码跑起来只是第一步真正让它变成你自己的项目得会改。改之前先做一件事把核心业务表的数据一致性验证跑一遍。我一般会写一个简单的对账脚本检查工单计划数量 各工序已完成数量之和以及库存扣减总量 报工数量按 BOM 展开的物料总量。这两个等式不成立说明事务边界或者并发控制有问题。-- 验证工单进度与工序进度是否一致 SELECT wo.order_no, wo.plan_qty, SUM(wp.finish_qty) AS process_total FROM mes_work_order wo JOIN mes_work_order_process wp ON wo.id wp.order_id GROUP BY wo.id HAVING wo.plan_qty SUM(wp.finish_qty); -- 验证库存扣减与报工消耗是否匹配 SELECT m.material_name, m.stock_qty, IFNULL(SUM(r.finish_qty * b.qty_per_unit), 0) AS should_consume FROM mes_material m LEFT JOIN mes_bom b ON m.id b.material_id LEFT JOIN mes_report r ON b.product_id r.product_id GROUP BY m.id HAVING m.stock_qty (m.init_qty - should_consume);第一条 SQL 找出工单总进度和工序进度之和不一致的记录第二条找出库存数量和理论消耗量对不上的物料。这两条查询在开发阶段每天跑一次能提前发现大部分数据问题。二次开发时我习惯先从字典表入手。MES 里大量字段是枚举值——工单状态、工序类型、质检结果、设备状态。源码里通常有一张sys_dict_data表存这些字典。加一个新状态或者改一个枚举值改字典表比改代码快得多也不用重新打包部署。但要注意字典值改了之后前端如果有硬编码的判断逻辑比如if (status 3)得同步改掉否则页面显示会出玄学问题。另一个实用技巧是给关键操作加操作日志。MES 系统里谁在什么时候改了工单数量这种追溯需求很常见。源码里如果集成了若依的日志模块直接用Log注解就能记录如果没有可以在 Service 层手动插入日志表。日志表建议按月份分表不然一年下来几百万条记录查询会变成黑匣子——你知道数据在里面但就是查不出来。最后说一个我踩过的坑源码里的定时任务。MES 通常有每日凌晨统计产量或者超期工单自动预警这类定时任务。如果用了 Quartz 或 Spring Schedule本地开发时记得把定时任务关掉或者改成手动触发不然你还在调试它已经把测试数据跑乱了。我一般会在application-dev.yml里加一个开关mes: task: enabled: false # 本地开发关闭定时任务从那以后我每次拿到新源码第一件事就是找定时任务配置并关掉第二件事是跑一遍数据对账 SQL。这两个习惯帮我省了无数个排查为什么数据莫名其妙变了的下午。希望这份拆解能帮你少走点弯路把这份 MES 源码真正用起来。本文还有配套的精品资源点击获取 Java MES生产管理系统源码实战：从环境搭建到二次开发全解析
简介这份基于Java的MES生产管理系统源码面向计算机相关专业的毕业设计学生、Java学习者以及希望了解制造执行系统架构的开发者。MES用于实时监控、控制和优化工厂生产流程源码覆盖生产计划管理、物料需求计划、车间控制、质量管理、人员与设备管理、数据采集及报表分析等核心模块适合作为完整项目案例进行研读与二次开发。压缩包共1140个文件约8.02MB以396个java源文件为主体配合268个js脚本、120个jsp页面及css、json、xml等配置与前端资源另有少量sql、properties文件整体结构清晰便于按模块检索。目前已有1431人学习下载。通过阅读这套源码读者可以理解Spring Boot、MyBatis等框架在MES中的落地方式掌握前后端分离与数据库设计的实践思路并在此基础上完成毕业设计或提升企业级Java开发能力。1. 从一份 Java MES 源码包说起它到底能跑通什么如果你正在做制造业信息化方向的毕业设计或者公司接了个中小型工厂的数字化改造单子大概率会遇到一个绕不开的词——MES。制造执行系统夹在 ERP 和车间设备之间管的是工单下发、工序流转、物料追溯、质量记录这些落地的活。市面上成熟的商业 MES 动辄几十万起步对预算有限的团队来说一份结构完整、能跑起来的 Java 源码包就是很好的起点。这份基于 Java 的 MES 生产管理系统源码核心价值在于把工单—工序—报工—质检—库存这条主线用可运行的代码串了起来。它不是那种只有登录页和几个空壳菜单的演示项目而是带了实体建模、权限控制、基础数据维护和业务流转逻辑的完整工程。适合三类人一是需要拿真实项目练手的 Java 学习者二是要做课程设计或毕业设计的学生三是想快速搭一个内部原型给老板看效果的小团队。下面我从技术栈拆解、环境搭建、核心模块实现到踩坑排查一步步说清楚怎么把它用起来。2. 技术栈拆解与环境搭建从 JDK 到数据库的完整链路2.1 先看清这套源码的技术底座拿到一个 Java 源码包第一件事不是急着导入 IDE而是先翻配置文件搞清楚它依赖什么。常见做法是打开pom.xmlMaven 项目或build.gradle看 Spring Boot 版本、持久层框架、数据库驱动和前端方案。这套 MES 源码的典型技术组合是Spring Boot 做基础框架MyBatis 或 MyBatis-Plus 做数据访问MySQL 存业务数据Redis 缓存会话和字典前端可能是 Thymeleaf 模板或者前后端分离的 Vue 工程。为什么这个组合值得关注因为 MES 的业务特点是读多写少但写操作要求强一致——工单状态变更、库存扣减、报工数量累加这些操作不能出现并发覆盖。MyBatis-Plus 提供的乐观锁和条件更新能覆盖大部分场景而 Spring Boot 的声明式事务让报工扣料更新工单进度能放在一个事务里。如果你之前只写过单体 CRUD这套源码能让你看到业务系统里事务边界是怎么划的。选型上还有一个容易被忽略的点JDK 版本。Spring Boot 2.x 通常配 JDK 8 或 11Spring Boot 3.x 要求 JDK 17 起步。源码里如果用了javax.*包名那就是 Spring Boot 2.x 体系如果看到jakarta.*说明是 3.x。这个判断直接决定你本地装哪个 JDK装错了连编译都过不去。2.2 环境搭建的实操步骤假设你本地是 Windows 或 macOS下面这套流程能覆盖 90% 的情况。先确认 JDK 装好并配了环境变量# 检查 JDK 版本输出应为 1.8.x 或 11.x 或 17.x java -version javac -version # 检查 Maven 是否可用 mvn -v如果java -version报不是内部或外部命令说明环境变量没配好。Windows 下需要把 JDK 的bin目录加到Path里macOS 或 Linux 下检查~/.bash_profile或~/.zshrc里的JAVA_HOME和PATH。这一步是新手翻车最多的地方别跳过。接下来建数据库。源码包里一般有个sql目录或者doc目录里面放着建表语句和初始数据-- 创建数据库字符集用 utf8mb4 避免中文乱码 CREATE DATABASE mes_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 导入建表脚本在命令行执行路径按实际调整 -- mysql -u root -p mes_db /path/to/mes_db.sql导入完成后去改application.yml或application.properties里的数据库连接spring: datasource: url: jdbc:mysql://localhost:3306/mes_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver这里有几个参数值得说清楚。serverTimezoneAsia/Shanghai不加的话MySQL 8.x 驱动会报时区错误characterEncodingutf8配合数据库的utf8mb4能避免工单备注里的中文变成问号。Redis 的配置同理如果源码里用了 Redis 做缓存记得本地启动 Redis 服务或者把缓存配置改成none先跑通主流程。最后启动项目# 在项目根目录执行跳过测试可以加快首次启动 mvn clean package -DskipTests # 运行打好的 jar 包 java -jar target/mes-*.jar # 或者直接用 Maven 插件启动 mvn spring-boot:run启动日志里看到Started Application in x.x seconds就说明服务起来了。浏览器访问http://localhost:8080默认账号密码通常在sql脚本的sys_user表里或者 README 里有说明。提示如果启动时报Table mes_db.xxx doesnt exist八成是建表脚本没导全检查sql目录下是不是有多个文件需要按顺序执行。3. 核心业务模块怎么读工单、工序与报工的数据流3.1 工单模块的实体关系与状态机MES 的心脏是工单。一份工单从创建到完工中间要经过待排产→已排产→生产中→待质检→已完工这几个状态。源码里通常用一张mes_work_order主表加一张mes_work_order_process工序明细表来实现。主表存工单号、产品、计划数量、优先级、状态明细表存每道工序的序号、名称、设备、计划工时、实际工时。读这块代码时重点看状态字段的类型和流转逻辑。常见做法是用Integer或String存状态码然后在 Service 层写一个updateStatus方法里面用if-else或状态机模式控制合法流转。比如已完工的工单不能再改回生产中这种校验如果漏了后面库存和报表全乱。// 工单状态流转的典型校验逻辑 public void updateWorkOrderStatus(Long orderId, WorkOrderStatus targetStatus) { WorkOrder order workOrderMapper.selectById(orderId); if (order null) { throw new BusinessException(工单不存在); } // 已完工的工单不允许再变更状态 if (WorkOrderStatus.COMPLETED.equals(order.getStatus())) { throw new BusinessException(工单已完工不可修改); } // 只有待排产状态才能排产 if (WorkOrderStatus.PENDING.equals(order.getStatus()) !WorkOrderStatus.SCHEDULED.equals(targetStatus)) { throw new BusinessException(待排产工单只能流转为已排产); } order.setStatus(targetStatus); workOrderMapper.updateById(order); }这段代码的逻辑说明先查工单是否存在再判断当前状态是否允许目标流转最后更新。参数orderId是工单主键targetStatus是目标状态枚举。实际项目里我会把状态流转规则抽成一张配置表或者用状态机框架因为硬编码的if-else在工序增加到十几道之后会变得很难维护。3.2 报工与库存扣减的事务边界报工是车间操作工最常用的功能扫工单条码输入完成数量、合格数量、不合格数量提交。这个动作背后至少涉及三张表的写操作——报工记录表插入一条、工单进度表更新已完成数量、库存表扣减原材料。这三步必须在一个事务里否则报工成功了但库存没扣月底盘点就对不上。Transactional(rollbackFor Exception.class) public void reportWork(ReportWorkDTO dto) { // 1. 插入报工记录 MesReport record new MesReport(); record.setOrderId(dto.getOrderId()); record.setProcessId(dto.getProcessId()); record.setFinishQty(dto.getFinishQty()); record.setQualifiedQty(dto.getQualifiedQty()); record.setUnqualifiedQty(dto.getUnqualifiedQty()); reportMapper.insert(record); // 2. 更新工单工序的已完成数量乐观锁防并发 int updated processMapper.increaseFinishQty( dto.getProcessId(), dto.getFinishQty(), dto.getVersion()); if (updated 0) { throw new BusinessException(报工冲突请刷新后重试); } // 3. 按BOM扣减原材料库存 ListMaterialConsume consumes bomService.calcMaterialConsume( dto.getOrderId(), dto.getFinishQty()); for (MaterialConsume mc : consumes) { int rows stockMapper.deductStock(mc.getMaterialId(), mc.getQty()); if (rows 0) { throw new BusinessException(库存不足 mc.getMaterialName()); } } }逻辑说明Transactional注解保证方法内所有数据库操作要么全成功要么全回滚。第二步用了乐观锁——increaseFinishQty的 SQL 里带version条件如果两个操作工同时报工只有一个能更新成功另一个会拿到updated0然后抛异常提示重试。第三步按 BOM 展开物料需求逐个扣减库存任何一个物料不够就整体回滚。参数方面dto.getFinishQty()是本次报工数量dto.getVersion()是前端传回来的版本号。这里有个容易踩的坑如果前端没把 version 传回来乐观锁就失效了。常见做法是在查询工序详情时把 version 一起返回给前端提交时原样带回。3.3 权限控制与行级数据隔离MES 系统里不同角色的可见范围差别很大。车间主任能看到所有工单普通操作工只能看到自己工位的任务质检员只能看待检工单。源码里如果用了若依框架或者类似的权限体系通常是通过PreAuthorize注解加角色来判断菜单和按钮权限。但行级权限——也就是同一个页面不同人看到不同数据——需要额外处理。常见做法是在 Mapper 的查询条件里动态拼入当前用户的部门或工位 ID!-- MyBatis XML 中的行级权限过滤 -- select idselectWorkOrderList resultTypeWorkOrderVO SELECT * FROM mes_work_order WHERE 11 if testuserId ! null and !isAdmin AND workshop_id IN ( SELECT workshop_id FROM sys_user_workshop WHERE user_id #{userId} ) /if if teststatus ! null AND status #{status} /if ORDER BY priority DESC, create_time ASC /select这段 SQL 的意思是非管理员用户只能看到自己所属车间的工单。sys_user_workshop是一张用户和车间的关联表。参数isAdmin由 Service 层根据当前登录用户的角色传入。这种写法比在 Java 代码里过滤要高效因为过滤发生在数据库层减少了数据传输量。注意行级权限的关联表如果没建索引工单量上万之后查询会明显变慢。建议在sys_user_workshop的user_id和workshop_id上分别建索引。4. 避坑与排查源码跑不起来时先查这五处4.1 启动报数据库连接失败现象启动日志里出现Communications link failure或Access denied for user。原因通常是数据库没启动、端口不对、用户名密码错或者 MySQL 8.x 的驱动类名写成了旧版的com.mysql.jdbc.Driver。解决办法先确认 MySQL 服务在运行然后用命令行mysql -u root -p能登进去再检查application.yml里的 URL 端口是不是 3306、驱动类是不是com.mysql.cj.jdbc.Driver。4.2 页面能打开但菜单全是空白现象登录成功左侧菜单树渲染出来了但点进去每个页面都是空白或者 404。原因一般是前端静态资源路径不对或者后端接口返回了 403。先按 F12 看 Network 面板如果接口返回 403说明当前账号的角色没分配对应的菜单权限如果返回 404检查 Controller 的RequestMapping路径和前端请求路径是否一致。解决办法去sys_role_menu表里给当前角色补上菜单关联或者直接用管理员账号登录验证功能是否正常。4.3 报工提交后库存没变化现象报工记录插入成功了工单进度也更新了但库存表的数据纹丝不动。原因通常是 BOM 配置为空——工单关联的产品没有维护物料清单calcMaterialConsume返回了空列表循环体没执行。解决办法检查mes_bom表里有没有该产品的物料明细如果没有就补上。另一个可能是库存扣减的 SQL 条件没匹配到记录比如物料 ID 传错了。4.4 中文乱码从数据库到页面一路飘红现象工单备注、产品名称里的中文在页面上显示成???或者乱码方块。原因链条比较长数据库字符集不是utf8mb4、连接 URL 没加characterEncodingutf8、前端页面没声明 UTF-8、Tomcat 的server.xml没配URIEncoding。解决办法从数据库建库语句开始逐层排查建库时用utf8mb4连接串加编码参数前端 HTML 的meta charsetUTF-8确认存在。如果是 Spring Boot 内嵌 Tomcat一般不用改server.xml但要在application.yml里加server.servlet.encoding.charsetUTF-8。4.5 并发报工时数据对不上现象两个操作工同时提交同一道工序的报工结果已完成数量只加了其中一个人的量另一个人的报工记录插入了但进度没更新。原因就是前面说的乐观锁失效——前端没传 version 或者 SQL 里没带 version 条件。解决办法检查increaseFinishQty的 SQL 是否包含AND version #{version}以及前端提交时有没有把查询到的 version 带回来。如果业务上不允许重试可以改成悲观锁SELECT ... FOR UPDATE但会牺牲并发性能。5. 从跑通到改顺二次开发与数据一致性验证技巧把源码跑起来只是第一步真正让它变成你自己的项目得会改。改之前先做一件事把核心业务表的数据一致性验证跑一遍。我一般会写一个简单的对账脚本检查工单计划数量 各工序已完成数量之和以及库存扣减总量 报工数量按 BOM 展开的物料总量。这两个等式不成立说明事务边界或者并发控制有问题。-- 验证工单进度与工序进度是否一致 SELECT wo.order_no, wo.plan_qty, SUM(wp.finish_qty) AS process_total FROM mes_work_order wo JOIN mes_work_order_process wp ON wo.id wp.order_id GROUP BY wo.id HAVING wo.plan_qty SUM(wp.finish_qty); -- 验证库存扣减与报工消耗是否匹配 SELECT m.material_name, m.stock_qty, IFNULL(SUM(r.finish_qty * b.qty_per_unit), 0) AS should_consume FROM mes_material m LEFT JOIN mes_bom b ON m.id b.material_id LEFT JOIN mes_report r ON b.product_id r.product_id GROUP BY m.id HAVING m.stock_qty (m.init_qty - should_consume);第一条 SQL 找出工单总进度和工序进度之和不一致的记录第二条找出库存数量和理论消耗量对不上的物料。这两条查询在开发阶段每天跑一次能提前发现大部分数据问题。二次开发时我习惯先从字典表入手。MES 里大量字段是枚举值——工单状态、工序类型、质检结果、设备状态。源码里通常有一张sys_dict_data表存这些字典。加一个新状态或者改一个枚举值改字典表比改代码快得多也不用重新打包部署。但要注意字典值改了之后前端如果有硬编码的判断逻辑比如if (status 3)得同步改掉否则页面显示会出玄学问题。另一个实用技巧是给关键操作加操作日志。MES 系统里谁在什么时候改了工单数量这种追溯需求很常见。源码里如果集成了若依的日志模块直接用Log注解就能记录如果没有可以在 Service 层手动插入日志表。日志表建议按月份分表不然一年下来几百万条记录查询会变成黑匣子——你知道数据在里面但就是查不出来。最后说一个我踩过的坑源码里的定时任务。MES 通常有每日凌晨统计产量或者超期工单自动预警这类定时任务。如果用了 Quartz 或 Spring Schedule本地开发时记得把定时任务关掉或者改成手动触发不然你还在调试它已经把测试数据跑乱了。我一般会在application-dev.yml里加一个开关mes: task: enabled: false # 本地开发关闭定时任务从那以后我每次拿到新源码第一件事就是找定时任务配置并关掉第二件事是跑一遍数据对账 SQL。这两个习惯帮我省了无数个排查为什么数据莫名其妙变了的下午。希望这份拆解能帮你少走点弯路把这份 MES 源码真正用起来。本文还有配套的精品资源点击获取