架构与系统设计 / 系统课时

命令失败时应该怎样表达

命令失败时应该怎样表达

业务命令并不一定能够执行成功。库存不足、余额不足、订单状态不允许等条件都可能让业务意图被拒绝。建模时需要区分“业务规则拒绝”“有业务意义的失败事实”和“技术异常”,否则很容易造出含糊的失败事件。

学习目标

  • 区分命令成功、业务拒绝与技术异常
  • 判断失败是否值得建模为领域事件
  • 用明确的业务原因表达命令无法执行的结果

业务拒绝不等于领域事件

假设用户发出“取消订单”命令,但订单已经发货。订单聚合检查规则后发现当前状态不允许取消,此时最直接的结果通常是拒绝命令并返回明确的业务错误,同时保持领域状态不变。

片段示例:下面表示事件风暴中的概念关系,不是程序代码。

text
[命令] 取消订单
        |
        +-- 状态允许 --> [事件] 订单已取消
        |
        +-- 已经发货 --> [业务拒绝] ORDER_ALREADY_SHIPPED

这里没有必要自动创建“取消订单失败”事件。因为命令本身只是一次请求,而请求被拒绝未必构成值得长期记录和传播的领域事实。

先判断失败发生在哪一层

命令没有成功时,可以先区分三类情况。

情况 典型例子 推荐表达
业务规则拒绝 库存不足、余额不足、状态不允许 返回明确业务错误,状态不变
有业务意义的负向结果 支付机构明确拒绝支付、库存预留正式失败 可以建模为领域事件
技术异常 数据库不可用、网络超时、进程崩溃 异常、重试或告警,不伪装成领域事件

例如“余额不足”如果只是转账命令执行前的一条校验规则,可以直接返回“余额不足”。但在支付业务中,外部支付机构已经完成一次审核并正式拒绝交易,“支付已拒绝”可能是后续通知、风控统计和再次支付流程都需要关注的事实,此时把它建模成领域事件就有价值。

命令成功、业务拒绝和技术异常的分流

不要使用笼统的失败名称

如果业务确实需要记录失败事实,事件名称仍然应该描述具体发生了什么,而不是简单使用“命令执行失败”。例如“支付已拒绝”“库存预留已失败”比“订单处理失败”包含更多领域信息,也更容易让后续流程正确响应。

同样,业务拒绝返回值也应该表达稳定、可理解的业务原因,例如 INSUFFICIENT_STOCK、INSUFFICIENT_BALANCE 或 ORDER_STATUS_NOT_ALLOWED。这些原因帮助调用方决定下一步动作,但它们本身不必全部升级为领域事件。

在事件风暴板面上保留被拒绝的路径

事件风暴讨论中,如果某个业务条件经常决定命令能否执行,就不应该只画成功路径。可以在命令旁明确记录规则或策略,并标出“库存不足”“余额不足”“当前状态禁止操作”等拒绝条件。

这样做的目的不是给每个失败都创建事件,而是让团队看到完整的业务决策:什么条件允许状态改变,什么条件会拒绝意图,以及哪些负向结果本身值得成为后续流程依赖的事实。

判断命令失败如何表达时,先问“业务世界究竟发生了什么”。如果只是请求没有通过规则,就返回业务拒绝;如果一个可被业务人员明确命名、需要持续关注的负向事实已经发生,再把它建模成领域事件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

命令失败时应该怎样表达

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通