车间要加工 1,000 件零件。工人完成第一批后,在终端输入“合格 95 件、不良 5 件”,点击提交。系统保存这次报工,班组长在看板上看到:已加工 100 件,还有 900 件待加工。
我们就从这件小事开始学习微服务。
先把它放进一个 Spring Boot 应用,再把看板拆出去。每走一步,只回答三个问题:现在遇到了什么问题,代码和数据怎么变化,失败以后怎么办。
读这篇之前,你只需要知道 Spring Boot 的 Controller 接收请求、Service 处理业务,以及数据库能保存记录。不熟悉 MES 也没关系,下面先解释业务词。本文的接口和事务伪代码用于理解设计;它们不是一套可以直接启动的完整工程,最后的练习需要在自己的项目中实现。
| 阅读阶段 | 要弄懂的事情 | 读到这里应该能做什么 |
|---|---|---|
| 第 1~3 节:先做出来 | 工单、报工、模块、本地事务 | 讲清一次报工会改哪些数据 |
| 第 4~6 节:再拆出去 | 服务边界、进程、HTTP | 讲清本地方法调用与远程调用的区别 |
| 第 7~10 节:处理失败 | 消息、幂等、补发、基础组件 | 解释重复提交与看板延迟怎么处理 |
| 第 11 节:动手验证 | 分阶段练习与验收 | 用同一个案例验证每一步 |
第一次阅读可以先完成前六节。把两个应用怎样协作弄明白,再继续学习消息。
1. 先看懂 MES 在做什么
MES 是 Manufacturing Execution System,即制造执行系统,负责跟踪和管理车间里的生产执行过程。可以先把它理解为:把“生产任务已经下达”到“现场实际做了多少、怎么做的”这段过程记录下来。它通常衔接企业计划与车间现场;具体分工会随工厂和系统而变化。SAP 的 MES 介绍可以帮助理解这一位置。
这篇只用到四个业务词:
| 词语 | 通俗解释 | 本文的例子 |
|---|---|---|
| 生产工单 | 给车间的一份生产任务 | 工单 WO-20260929-001,计划加工 1,000 件外壳 |
| 工序 | 完成产品需要经过的一步加工 | 本例只保留“装配”一道工序 |
| 报工 | 记录某次实际完成的生产工作 | 本次合格 95 件、不良 5 件,共加工 100 件 |
| 生产看板 | 把生产进度展示出来的页面 | 显示该工单的计划数、已加工数和待加工数 |
为了集中学习服务拆分,本文约定一个工厂、一条产线、一道工序。工单创建后处于“已下达”,点击开工后才能报工。数量使用整数,不允许超计划报工,也暂不处理返工、补产、报工撤销和多工序流转。
这里的“计划 1,000 件”指计划加工数量。95 件合格加 5 件不良,都计入本例的已加工数量:
计划加工:1000 件本次报工:95 件合格 + 5 件不良 = 100 件累计加工:100 件待加工:1000 - 100 = 900 件实际工厂可能以合格交付数量作为目标,不能直接照搬这个计算口径。报工成功也不代表质检已经放行,更不代表成品已经入库。 本文只记录工人上报的数量,正式检验与入库是后续业务。
整条流程如下:
先记住这条流程。后面出现的每个技术概念,都放回这里解释。
2. 第一版:一个应用就够了
先建立一个 mes-app。按业务分成工单、报工、看板三个模块,每个模块内部再放 Controller、Service 和数据库访问代码。
mes-app└── src/main/java/com/example/mes ├── MesApplication.java ├── workorder 工单:下达、开工、查看进度 │ ├── WorkOrderController.java │ ├── WorkOrderService.java │ └── WorkOrderRepository.java ├── reporting 报工:校验、保存本次完成数量 │ ├── WorkReportController.java │ ├── WorkReportService.java │ └── WorkReportRepository.java └── dashboard 看板:展示工单进度 ├── DashboardController.java └── DashboardService.java这里 reporting 指“报工”,dashboard 指“看板”,避免把两种业务混在一起。
模块只是代码的组织方式。 上面虽然有多个包,仍然只有一个 Spring Boot 启动入口,打出一个 jar,在同一个进程里运行。这叫模块化单体。
进程可以先理解为“一份正在运行的程序”。单体也能启动多个实例、部署到多台服务器,判断单体不能只看服务器数量。
第一版只需要三张业务表:
| 表 | 主要字段 | 谁负责维护 |
|---|---|---|
work_order | 工单号、产线、计划数、状态、累计合格数、累计不良数 | 工单模块 |
work_report | 报工号、工单号、本次合格数、本次不良数、记录时间、处理结果快照 | 报工模块 |
production_line | 产线编号、产线名称 | 先作为基础资料保留在应用内 |
看板暂时不存另一份数量,通过工单模块提供的查询方法获取数据。报工模块更新工单进度,也通过工单模块的方法完成;不要到处直接操作别的模块的表。
此时看板查工单,发生的是一次本地方法调用:
// 局部示意:两个对象都在 mes-app 进程里。WorkOrderSummary summary = workOrderService.getSummary(workOrderNo);这一行没有发 HTTP 请求,也不需要注册中心。模块边界清楚以后,即使暂时保持单体,代码也已经更容易维护。
3. 跟着一次报工,理解本地事务
假设工单已经开工,状态为 RUNNING,累计数量为 0。工人完成第一批 100 件后,终端提交如下请求。
下面的 http 代码块是接口约定示例,不是终端命令;接口需要由你的应用实现。
POST /api/work-reportsContent-Type: application/json
{ "reportNo": "RPT-001", "workOrderNo": "WO-20260929-001", "goodQty": 95, "defectQty": 5}字段含义很直接:reportNo 是这一次报工的唯一业务编号,workOrderNo 指向工单,后两个字段是本次新增的数量,不是累计数量。产线由工单确定,记录时间由服务端生成。
终端在第一次提交之前生成报工号,并在重试时沿用它。下一次真实报工才生成新的编号;如果每点一次重试都换号,服务端就无法知道这是同一笔业务。
3.1 接口背后要一起完成两件事
一是插入报工明细,二是增加工单累计数量。它们应当在同一个数据库的同一个本地事务中完成。
事务在这里的含义是:这两项数据库变更要么一起提交,要么一起撤销。不能出现“明细保存了,工单进度没有增加”的一半结果。
下面是事务逻辑的伪代码,重点看顺序,不需要背方法名:
开始本地事务 1. 按工单号锁定并读取目标工单;不存在则拒绝 2. 取得锁之后,按 reportNo 读取最新的报工记录 - 已处理且工单号、数量相同:返回上次保存的处理结果 - 已处理但内容不同:拒绝,不能用旧编号提交新内容 3. 校验:工单状态是 RUNNING 4. 校验:数量都是非负整数,合计大于 0 5. 校验:累计加工数 + 本次数量不超过计划数 6. 插入报工明细,reportNo 由数据库唯一约束保护 7. 增加工单累计合格数和不良数,保存本次处理结果提交事务返回报工成功进阶理解:两个人同时报工,或者同一个请求同时到达,会怎样?
“锁定工单”是为了让同一工单上的并发报工依次检查和更新数量。否则,两个人都读到“还剩 100 件”,各提交 80 件,就可能超报。实现时可以使用数据库行锁,或使用带版本条件的更新并处理冲突;只有 @Transactional 并不能自动解决这种并发问题。
取得锁之后再查报工号,是为了看到前一个请求已提交的结果;它要放在工单状态和剩余数量校验之前。这样,一笔成功报工即使被重试,也不会因为工单后来已结束或数量已满而被误判为失败。若在加锁前做了快速查询,取得锁后仍要重新读取最新记录,不能沿用旧查询结果。
应用里的查询仍不能替代数据库唯一约束,例如不同工单的请求可能误用了同一个报工号。若插入时发生重复编号冲突,应回滚本次事务,再读取已提交的原记录并比较内容,不能继续累计数量。
3.2 返回什么,页面就显示什么
首次成功提交后,接口返回下面的业务结果。这里的累计值是本次提交后的快照,同一报工重试时返回原结果;要看最新进度,再查询工单接口。
{ "reportNo": "RPT-001", "workOrderNo": "WO-20260929-001", "result": "RECORDED", "reportedQtyAfter": 100, "remainingQtyAfter": 900}页面可以显示“报工已保存”,随后刷新看板。不要把这个结果显示成“产品已入库”。
本例的工单状态也保持简单:
| 当前状态 | 允许的动作 | 下一状态 |
|---|---|---|
RELEASED,已下达 | 开工 | RUNNING,生产中 |
RUNNING,生产中 | 多次报工 | 仍是 RUNNING |
RUNNING,且累计加工数达到 1,000 | 确认加工结束 | COMPLETED,加工结束 |
加工结束仍不等于质量合格或库存可用。确认结束也要与报工使用同一套工单并发控制,防止状态变更和报工互相覆盖。
在配置好数据库事务管理后,Spring 的 @Transactional 可以帮助管理这种本地事务。但它不会通过一次普通 HTTP 调用,自动把另一个服务的数据库操作也纳入同一个事务。Spring 事务文档说明了远程调用的这一边界。
到这里,已经可以完成一个小型 MES 的报工流程。现在才需要讨论是否拆服务。
4. 什么时候值得拆:先找一个具体问题
假设系统运行一段时间后,出现这样的需求:
看板团队频繁增加统计页面和历史报表,希望能单独发布;报工终端则希望尽量少受这些改动影响。
这给了我们一个清晰的拆分理由:让看板和生产执行分别发布、分别运行。 如果还有大量统计查询,则需要进一步考虑让看板拥有自己的查询数据,减少对生产库的压力。
不是看到三个模块,就必须拆成三个服务。判断一个模块适不适合先拆,可以问:
| 问题 | 看板在本例中的答案 |
|---|---|
| 职责能否说清楚? | 负责展示生产进度,不决定报工能否成功 |
| 是否需要单独变化? | 统计页面经常改,发布节奏不同 |
| 数据能否允许短暂延迟? | 本例约定允许数秒延迟,页面显示更新时间 |
| 拆出后是否会破坏关键事务? | 工单和报工仍留在一起,不拆开它们的本地事务 |
这里“允许数秒延迟”是本案例的产品约定,需要在真实项目中确认。用于控制工序放行、设备动作的判断,不能直接使用这个可能滞后的看板数据。
所以,第一刀只拆看板。工单与报工暂时一起保留在生产服务里。
5. 从一个应用变成两个服务,究竟改了什么
拆分后,有两个独立启动的 Spring Boot 应用:
production-service:生产服务,本地练习端口 8081 ├── 工单模块 ├── 报工模块 └── 基础资料
dashboard-service:看板服务,本地练习端口 8082 └── 看板查询与展示数据的组织每个服务内部仍然有自己的 Controller、Service 和数据库访问代码。不要拆成 controller-service、mapper-service,也不要因为一张表就新建一个服务。
在这个例子里,微服务意味着:围绕业务职责,把程序拆成可以独立运行、发布和扩展的服务;服务之间通过约定的接口或消息协作。 两个应用可以先在同一台电脑上学习,不需要先准备两台服务器。
为了不一下引入太多东西,接下来分两步演进:
| 版本 | 看板从哪里拿数据 | 这一步学什么 |
|---|---|---|
| A:单体 | 调用本进程的工单查询方法 | 模块边界、本地事务 |
| B:两个服务,先用 HTTP | 请求生产服务的工单进度接口 | 远程调用与失败处理 |
| C:两个服务,再用消息 | 查询看板自己的数据副本 | 异步同步与数据独立 |
B 是学习通信的过渡版本。 看板每次仍要访问生产服务,并没有消除生产库的查询压力。C 才进一步把看板查询从生产数据的在线读取中分离出来。
6. 先用 HTTP,让两个服务说上话
在 B 版本中,班组长打开看板,调用链如下:
生产服务提供一个只读接口:
GET http://localhost:8081/api/work-orders/WO-20260929-001/summary它返回的数据约定如下。DTO,即数据传输对象,可以先理解为“接口约定的一组字段”;双方通过它沟通,不需要暴露整张数据库表。
{ "workOrderNo": "WO-20260929-001", "lineCode": "LINE-A", "planQty": 1000, "goodQty": 95, "defectQty": 5, "reportedQty": 100, "remainingQty": 900, "status": "RUNNING"}看板服务通过 HTTP 客户端读取这个 JSON,组织成看板接口的响应。业务上的查询意图没有变,执行过程却变了:
A 版本:看板模块 → 本进程里的工单对象 → 得到结果B 版本:看板服务 → HTTP 请求 → 生产服务处理 → HTTP 响应OpenFeign、Spring 的 HTTP 客户端等工具,可以帮助完成请求与 JSON 转换。但即使代码看起来像调用一个 Java 方法,中间也仍然经过网络。
因此至少要考虑两件事:
- 等待多久。 设置连接和响应超时,不能让请求无限等下去。超时值应根据调用预算和实际耗时确定。
- 失败怎么展示。 生产服务不可用时,看板显示“暂时无法获取进度”,或者展示带时间标记的旧数据。不能把请求失败转换成“当前产量是 0”。
本地练习可以把 http://localhost:8081 放进配置文件。只有地址管理变复杂时,才继续学习服务发现。两个服务能通过 HTTP 通信,不以安装 Spring Cloud 全家桶为前提。
反过来看报工:终端仍向生产服务提交请求,报工成功不需要调用看板服务。这样看板停机时,生产服务仍有机会独立工作;实际隔离程度还取决于是否共用了数据库、连接池或机器资源。
7. 再引入消息,让看板拥有自己的数据
现在进入 C 版本。我们希望看板只查询自己的数据库,生产服务在报工后告诉它:“刚刚新增了一条报工记录。”
这种对已发生事实的描述,叫事件。本例把它命名为 WorkReported,意思是“报工已经记录成功”。
7.1 一条事件应该让接收方看得懂
{ "eventId": "EVT-RPT-001", "eventType": "WorkReported", "schemaVersion": 1, "reportNo": "RPT-001", "workOrderNo": "WO-20260929-001", "lineCode": "LINE-A", "goodQty": 95, "defectQty": 5, "recordedAt": "2026-09-29T09:30:00+08:00"}reportNo 标识业务上的一次报工,eventId 标识一次事件。这里为了便于阅读用了简短编号;真实实现要保证它们在约定范围内唯一,重发同一事件时保留原 eventId。schemaVersion 表示消息格式的版本。
事件里的 95 和 5 仍然是本次增量。看板处理成功后,累计数增加 100。因为本例只接收不可修改的新增报工,同一工单的这些增量即使乱序到达,也可以在正确去重后累加;不要把这个结论套用到工单状态变更或“用最新值覆盖旧值”的消息上。
7.2 为什么不能只写一行“发送消息”
最容易写出的流程是:
保存报工 → 提交事务 → 发送消息如果应用在提交之后、发送之前退出,报工已经成功,看板却一直收不到通知。反过来,先发消息再提交数据库,也可能让看板统计一笔最终回滚的报工。
解决这个缺口的一种办法是 Outbox(本地消息表):把“需要发送的事件”也保存在生产数据库里。
生产服务的同一个本地事务 写报工明细 更新工单累计数量 写一条待发送事件到 outbox_event一起提交 → 向终端返回“报工已保存”只有新报工会新增事件;同一报工号的重试返回原结果,不再生成新的事件。之后由一个后台投递任务读取已提交的待发送事件,发送给消息队列。
MQ 是 Message Queue,即消息队列。生产服务负责发布事件,看板服务负责接收并处理;RabbitMQ 等消息中间件可以承接这段传递过程。
投递任务只有确认 MQ 已接收并成功路由到目标队列后,才能把事件标成已发送。超时、无法路由或结果不确定时,都要保留事件供重试;“调用发送方法没有抛异常”并不足以证明消息已经可靠送达。
现在,“报工成功”和“看板已更新”是两个不同的时刻。这叫最终一致性:允许短暂不同步,并通过持续投递、重试与核对让数据最终追上来。它不意味着可以放任错误不处理,也不意味着延迟一定有固定上限。
7.3 数据归属也要跟着拆
| 服务 | 自己负责的数据 | 不应该直接做的事 |
|---|---|---|
| 生产服务 | 工单、报工、待发送事件 | 直接修改看板的汇总表 |
| 看板服务 | 工单展示副本、报工汇总、已处理事件编号 | 直接读写生产库里的工单和报工表 |
最初可以用同一台数据库服务器上的不同数据库和账号,逐步限制访问范围;这仍然共享底层资源,不能把它当成完整的性能或故障隔离。
看板的计划数量与工单状态也需要来源。要保留前面的完整工单看板,可以让工单下达、开工和加工结束事件携带完整的展示快照,配合工单版本号维护副本,防止旧状态覆盖新状态。只订阅 WorkReported,并不足以复制整个工单的生命周期。 最后的入门练习先只做“累计报工数量”,避免一次实现所有事件。
看板是用于查询的副本,生产服务中的工单和报工记录才是业务依据。新建看板时,历史数据还要专门回填,并设计与后续事件衔接的去重范围,不能指望新消费者自动收到过去的全部消息。
8. 用三个故障,学会幂等和重试
8.1 报工已成功,终端却没有收到响应
终端提交 RPT-001 → 生产服务提交成功,累计数量变成 100 → 网络中断,终端没有收到响应 → 终端用原来的 RPT-001 再次提交第二次必须返回原来的处理结果,累计数仍然是 100,不能变成 200。
这叫幂等:同一笔业务重复到达,不产生第二次业务效果。第 3 节的报工号、内容比较和唯一约束,就是为这种情况准备的。
注意:超时只能说明调用方没有及时拿到结果,不能证明服务端没有执行成功。终端可以先显示“结果待确认”,使用原编号重试或查询处理结果。
8.2 消息已经发出,投递任务却没能记下成功
Outbox 的投递任务可能在消息发送成功之后、更新发送状态之前退出。恢复后,它会再次发送同一条事件。
所以,本地消息表解决了“成功报工后还有事件可补发”的问题,仍然可能产生重复消息。看板需要在自己的同一个本地事务中完成两项操作:
开始看板本地事务 插入已处理事件记录,eventId 有唯一约束 按 workOrderNo 创建或更新汇总,对数量进行原子累加提交事务再向消息队列确认处理成功如果 eventId 已经存在且内容一致,就跳过累计并确认这条重复消息。如果同一编号对应了不同内容,应记录异常并排查。
去重记录和数量更新必须一起提交,否则可能出现“已经标成处理过,数量却没增加”。汇总表也要对 workOrderNo 建立唯一约束:首条事件创建汇总行,后续事件累加。可以使用数据库的原子插入或更新语句,不能在空表上执行一次影响 0 行的更新,就把事件标成已处理。不同事件并发累加同一工单时,也要使用原子更新或锁,避免相互覆盖。
8.3 看板停机半小时
这时生产服务仍然保存报工和待发送事件。看板恢复后继续处理积压,逐步追上生产进度。
但“恢复后会追上”有条件:需要正确配置消息持久化与确认机制,保留未完成的事件,给重试失败的任务报警,并能够重新投递或核对修复。单纯接入一个 MQ 不会自动完成这些工作。
| 观察到的现象 | 处理方式 |
|---|---|
| 数据库事务失败 | 返回报工失败,不留下半条业务结果或待发送事件 |
| MQ 暂时不可用 | 已成功报工仍有效,待发送事件保留并重试 |
| 看板长时间没追上 | 展示同步状态,检查积压并报警,不把旧值冒充实时值 |
| 某条消息反复失败 | 保留失败记录供修复与重放,避免无休止快速重试 |
看板页面可以显示“最近同步时间”和是否存在积压。最近处理了一条消息,并不能单独证明所有旧消息都已处理完成,后台还需要检查待发送、待消费与失败记录。
如果以后加入报工撤销或更正,需要设计对应的业务记录和修正事件,不能只改生产库原记录,然后期待看板自动知道变化。
9. 注册中心、网关这些组件,什么时候再学
理解前面的流程后,再看组件名字就容易多了。Spring Boot 用来构建应用;Spring Cloud 提供多种分布式系统工具。使用了 Spring Boot,不等于已经做成微服务。
把组件放回这个 MES 案例中:
| 遇到的问题 | 要理解的能力 | 可以继续学习的工具或方式 |
|---|---|---|
| 生产服务有多个实例,地址会变化 | 服务发现:按服务名找到可调用的实例;再选择其中一个 | 注册中心,例如 Nacos;部署平台的服务发现 |
| 前端要分别记住 8081 和 8082 | 统一入口:按请求路径转发到目标服务 | Spring Cloud Gateway |
| 多个应用的地址、超时等配置难以管理 | 集中配置:统一管理和分发参数 | 配置中心,例如 Spring Cloud Config |
| 下游变慢导致调用方长期等待 | 超时、限制并发、熔断 | HTTP 客户端配置和服务保护组件 |
| 报工成功,但看板允许稍后更新 | 异步事件传递 | MQ,例如 RabbitMQ |
| 一次请求跨多个服务,难以定位耗时 | 关联日志与链路追踪 | traceId,以及追踪工具 |
例如网关可以转发 /api/work-reports 到生产服务、/api/dashboards 到看板服务。它负责入口路由,工单能不能报工仍由生产服务判断。Spring Cloud Gateway 官方文档介绍了这种路由能力。
服务发现也不是把所有业务请求交给注册中心转发:调用方通常先获取服务实例信息,再向目标实例发起请求。具体也可以由部署平台完成。
配置中心也不意味着“所有配置一改就生效”。应用需要支持相应的刷新机制,部分配置仍可能需要重启;可以参照 Spring Cloud 的刷新机制说明。
“熔断”可以先理解为:发现某个下游持续失败时,暂时停止继续调用它,避免大量请求一起等待。看板可以降级为显示旧数据或不可用;关键生产校验失败时不能伪造“校验通过”。
排查时也区分三个编号:
reportNo:是哪一笔报工,决定业务去重。eventId:是哪一条事件,决定消息去重。traceId:关联一次调用链上的日志与耗时,不替代业务编号;重试可能产生新的调用链。
第一次练习先用两个应用、固定本地地址和清楚的日志。确认自己知道每个组件要解决的问题,再逐项加入。
10. 扩展到真实 MES 时,边界怎样继续划
入门之后,MES 还可能涉及工艺、质量、设备、物料等能力。下面是帮助分析职责的例子,不是一张要求全部独立部署的清单。
| 业务能力 | 可能负责什么 | 拆分前要问什么 |
|---|---|---|
| 生产执行 | 工单、开工、报工、加工结束 | 哪些状态和数量必须一起提交? |
| 工艺管理 | 工序顺序、作业要求、工艺版本 | 工单执行时依据哪个已确定的版本? |
| 质量管理 | 检验记录、判定、质量放行 | 未放行时是否必须禁止转序? |
| 设备管理 | 设备状态、维护、采集数据 | 高频采集是否需要独立承担? |
| 物料协同 | 领料、退料、消耗记录,以及与仓储系统协作 | 库存归谁管理,预留失败如何处理? |
| 看板与报表 | 进度展示、统计、历史查询 | 允许多长延迟,怎样检查同步完整性? |
假设未来把物料单独拆开,开工前必须先预留物料,这时就出现跨服务协作:生产服务发起预留,物料服务保存预留结果。
如果请求超时,不能直接当作预留失败,也不能直接把工单改成已开工。可以先记录“预留结果待确认”,用稳定的业务编号查询或重试,明确成功后再推进工单;取消时还要处理预留释放与迟到结果。
这才是分布式一致性要解决的问题。后续可以学习补偿、Saga 或 TCC 等方案,但前提是先弄清业务状态和失败路径。能留在同一个服务、本地事务内完成的强关联操作,入门阶段先保留在一起。
11. 动手练习:每次只增加一个难点
不用一次装齐所有中间件。在自己的 Spring Boot 项目中按下面三关推进,数据库中的记录与接口结果就是验收依据。前两关只需要 Spring Boot 和关系数据库;第三关再加入 MQ。
第一关:做出单体报工
先创建第 2 节的模块和三张业务表,为 reportNo 建立唯一约束,准备产线 LINE-A。实现下面几个接口;这是本练习约定的路由,可按自己的项目风格调整。
| 接口 | 作用 |
|---|---|
POST /api/work-orders | 创建并下达工单,设置产线与计划加工数 |
POST /api/work-orders/{workOrderNo}/start | 把已下达工单改为生产中 |
POST /api/work-reports | 按第 3 节规则保存报工 |
GET /api/work-orders/{workOrderNo}/summary | 查询工单状态和累计数量 |
使用工单 WO-20260929-001、计划数 1,000,按顺序检查:
- 没开工就报工:拒绝,没有报工明细,累计数为 0。
- 开工后提交
RPT-001,95 + 5:成功,一条明细,累计 100,待加工 900。 - 用同一编号和内容重复提交:仍然只有一条明细,累计仍为 100。
- 沿用
RPT-001,却把数量改成 96 + 5:拒绝,原记录和累计数不变。 - 用新编号提交负数、合计为 0,或新增 901 件:拒绝,累计仍为 100。
- 用
RPT-002提交 190 + 10:成功,两条明细,累计合格 285、不良 15,共 300 件,待加工 700。
然后在测试环境中,让“插入明细之后、累计工单之前”发生异常,验证两项写入都回滚。再并发提交重复编号以及两笔合计超剩余数量的报工,验证唯一约束和数量校验确实生效。
通过标准:能解释每条记录为什么存在,数量为什么是 300,而不是只看页面提示成功。
第二关:拆出看板,验证一次远程查询
把原单体中的工单与报工保留为 production-service,端口设为 8081。新建 dashboard-service,端口设为 8082,提供 GET /api/dashboards/work-orders/{workOrderNo},通过 HTTP 查询生产服务的工单进度。
先配置固定本地地址和超时,沿用第一关的 300 件数据。
- 两个应用都运行:看板得到累计 300、待加工 700。
- 停止生产服务:看板在设定的超时内返回不可用,不能返回产量 0。
- 恢复生产服务、停止看板服务:通过生产服务直接报工仍能成功。
- 重启看板:再次查询应能看到生产服务的最新数据。
第三关将使用独立的空练习库重新执行,不依赖本关新增的数据,也不需要清理实际业务数据。
通过标准:能在两个进程的日志里找到请求,并说明哪一步是网络调用。
第三关:改成消息同步,验证重复与中断
在生产库加入 outbox_event,在看板库加入报工汇总与已处理事件表。按第 7、8 节实现后台投递、消费去重和事务内累计。
本关从空的练习库开始,先把消费者与队列准备好,再创建工单并提交前两笔报工。只验收按工单统计的合格数、不良数和累计加工数;计划数、剩余数与工单状态的同步留作后续扩展,不继续暗中调用生产库来补齐。
| 操作 | 应当看到的结果 |
|---|---|
提交 RPT-001 和 RPT-002 | 生产端累计 300;看板最终也为 300 |
重放 RPT-001 对应的原事件,保持同一个 eventId | 看板仍为 300 |
停止看板,提交 RPT-003,48 合格 + 2 不良 | 生产端成功且累计 350,看板尚未处理新事件 |
| 恢复看板 | 最终合格 333、不良 17,累计 350 |
再停止 MQ,提交 RPT-004,9 合格 + 1 不良 | 生产端累计 360,待发送事件仍可找到 |
| 恢复 MQ,等投递和消费完成 | 看板最终合格 342、不良 18,累计 360 |
若长期没有追上,不要手动把页面数字改对就结束。沿着“报工记录 → 待发送事件 → 队列 → 消费记录 → 汇总”找出卡点,修复后重放并确认不会重复累计。
通过标准:看板短暂停机不阻止报工,同一事件重复到达不重复计数,恢复后有办法确认数据追上。需要补充 MQ 基础时,可以接着读 MQ 从 0 到 1(一):为什么需要消息队列;那篇使用订单通知举例,异步、Outbox 与幂等的思路可以迁移到这里。
当你能解释“为什么工单与报工先放一起,为什么看板可以晚一点,为什么重试以后数量仍然正确”,就已经掌握了这篇要学习的服务拆分方法。下一步再加入注册中心或网关,每个组件都会有明确的用途。
If this article helped you, please share it with others!
Some information may be outdated






