架构与系统设计 / 系统课时
命令失败时应该怎样表达
命令失败时应该怎样表达
业务命令并不一定能够执行成功。库存不足、余额不足、订单状态不允许等条件都可能让业务意图被拒绝。建模时需要区分“业务规则拒绝”“有业务意义的失败事实”和“技术异常”,否则很容易造出含糊的失败事件。
学习目标
- 区分命令成功、业务拒绝与技术异常
- 判断失败是否值得建模为领域事件
- 用明确的业务原因表达命令无法执行的结果
业务拒绝不等于领域事件
假设用户发出“取消订单”命令,但订单已经发货。订单聚合检查规则后发现当前状态不允许取消,此时最直接的结果通常是拒绝命令并返回明确的业务错误,同时保持领域状态不变。
片段示例:下面表示事件风暴中的概念关系,不是程序代码。
[命令] 取消订单
|
+-- 状态允许 --> [事件] 订单已取消
|
+-- 已经发货 --> [业务拒绝] ORDER_ALREADY_SHIPPED这里没有必要自动创建“取消订单失败”事件。因为命令本身只是一次请求,而请求被拒绝未必构成值得长期记录和传播的领域事实。
先判断失败发生在哪一层
命令没有成功时,可以先区分三类情况。
| 情况 | 典型例子 | 推荐表达 |
|---|---|---|
| 业务规则拒绝 | 库存不足、余额不足、状态不允许 | 返回明确业务错误,状态不变 |
| 有业务意义的负向结果 | 支付机构明确拒绝支付、库存预留正式失败 | 可以建模为领域事件 |
| 技术异常 | 数据库不可用、网络超时、进程崩溃 | 异常、重试或告警,不伪装成领域事件 |
例如“余额不足”如果只是转账命令执行前的一条校验规则,可以直接返回“余额不足”。但在支付业务中,外部支付机构已经完成一次审核并正式拒绝交易,“支付已拒绝”可能是后续通知、风控统计和再次支付流程都需要关注的事实,此时把它建模成领域事件就有价值。

不要使用笼统的失败名称
如果业务确实需要记录失败事实,事件名称仍然应该描述具体发生了什么,而不是简单使用“命令执行失败”。例如“支付已拒绝”“库存预留已失败”比“订单处理失败”包含更多领域信息,也更容易让后续流程正确响应。
同样,业务拒绝返回值也应该表达稳定、可理解的业务原因,例如 INSUFFICIENT_STOCK、INSUFFICIENT_BALANCE 或 ORDER_STATUS_NOT_ALLOWED。这些原因帮助调用方决定下一步动作,但它们本身不必全部升级为领域事件。
在事件风暴板面上保留被拒绝的路径
事件风暴讨论中,如果某个业务条件经常决定命令能否执行,就不应该只画成功路径。可以在命令旁明确记录规则或策略,并标出“库存不足”“余额不足”“当前状态禁止操作”等拒绝条件。
这样做的目的不是给每个失败都创建事件,而是让团队看到完整的业务决策:什么条件允许状态改变,什么条件会拒绝意图,以及哪些负向结果本身值得成为后续流程依赖的事实。
判断命令失败如何表达时,先问“业务世界究竟发生了什么”。如果只是请求没有通过规则,就返回业务拒绝;如果一个可被业务人员明确命名、需要持续关注的负向事实已经发生,再把它建模成领域事件。