mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4
8259 words
21 minutes
微服务从 0 到 1:用 MES 工单与报工学会服务拆分
2024-10-26
2026-09-29

车间要加工 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 件

实际工厂可能以合格交付数量作为目标,不能直接照搬这个计算口径。报工成功也不代表质检已经放行,更不代表成品已经入库。 本文只记录工人上报的数量,正式检验与入库是后续业务。

整条流程如下:

flowchart TD A["计划员创建并下达工单"] --> B["班组长开工"] B --> C["工人提交本次报工"] C --> D["保存报工并累计工单数量"] D --> E["班组长查看生产看板"]

先记住这条流程。后面出现的每个技术概念,都放回这里解释。

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-reports
Content-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 版本中,班组长打开看板,调用链如下:

sequenceDiagram participant U as 班组长的浏览器 participant D as 看板服务 8082 participant P as 生产服务 8081 U->>D: 查询工单看板 D->>P: GET 工单进度接口 P-->>D: 返回进度 JSON D-->>U: 返回看板数据

生产服务提供一个只读接口:

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 方法,中间也仍然经过网络。

因此至少要考虑两件事:

  1. 等待多久。 设置连接和响应超时,不能让请求无限等下去。超时值应根据调用预算和实际耗时确定。
  2. 失败怎么展示。 生产服务不可用时,看板显示“暂时无法获取进度”,或者展示带时间标记的旧数据。不能把请求失败转换成“当前产量是 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 已接收并成功路由到目标队列后,才能把事件标成已发送。超时、无法路由或结果不确定时,都要保留事件供重试;“调用发送方法没有抛异常”并不足以证明消息已经可靠送达。

flowchart TD A["工人提交报工"] --> B["生产服务提交本地事务"] B --> C["报工记录 + 工单数量 + 待发送事件"] B --> D["终端收到报工成功"] C --> E["后台投递任务"] E --> F["消息队列"] F --> G["看板服务处理事件"] G --> H["看板自己的数据库"] H --> I["浏览器查询生产看板"]

现在,“报工成功”和“看板已更新”是两个不同的时刻。这叫最终一致性:允许短暂不同步,并通过持续投递、重试与核对让数据最终追上来。它不意味着可以放任错误不处理,也不意味着延迟一定有固定上限。

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,按顺序检查:

  1. 没开工就报工:拒绝,没有报工明细,累计数为 0。
  2. 开工后提交 RPT-001,95 + 5:成功,一条明细,累计 100,待加工 900。
  3. 用同一编号和内容重复提交:仍然只有一条明细,累计仍为 100。
  4. 沿用 RPT-001,却把数量改成 96 + 5:拒绝,原记录和累计数不变。
  5. 用新编号提交负数、合计为 0,或新增 901 件:拒绝,累计仍为 100。
  6. 用 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 与幂等的思路可以迁移到这里。

当你能解释“为什么工单与报工先放一起,为什么看板可以晚一点,为什么重试以后数量仍然正确”,就已经掌握了这篇要学习的服务拆分方法。下一步再加入注册中心或网关,每个组件都会有明确的用途。

Share

If this article helped you, please share it with others!

微服务从 0 到 1:用 MES 工单与报工学会服务拆分
https://mizuki.mysqil.com/posts/microservices-beginner-guide/
Author
梦幻晨风
Published at
2024-10-26
License
CC BY-NC-SA 4.0

Some information may be outdated

Table of Contents