订单状态类不能用字符串或枚举硬编码,因业务规则增多会导致逻辑散落、易出错、难测试;状态模式将“允许操作+禁止操作+迁移结果”封装进状态类,通过委托和状态实例切换实现高内聚、可维护的状态管理。

订单状态类为什么不能用字符串或枚举硬编码
直接用 "shipped" 或 OrderStatus.SHIPPED 表示状态,看似简单,但一旦业务要求“发货后 24 小时内可取消”“已签收不可退换”“支付超时自动关单”,逻辑就会散落在各处判断里,容易漏掉约束、改错分支、难以测试。状态模式的核心价值不是炫技,是把「某个状态下允许做什么 + 不允许做什么 + 做完后变成什么」这三件事,打包进一个类里。
关键判断:如果订单对象的 cancel()、ship()、confirm() 等方法需要反复检查当前状态再分支执行,就该拆了。
如何定义状态基类和具体状态类
基类不负责业务逻辑,只声明接口并抛出默认异常——强制子类覆盖。所有状态类共享同一个上下文(即订单实例),通过它读取数据、触发状态迁移、调用外部服务。
-
OrderState基类只定义cancel()、ship()、pay()等空方法,每个都 raiseNotImplementedError - 具体状态类如
PendingPaymentState只实现它真正能响应的操作,比如允许pay(),但对ship()直接 raiseInvalidStateTransitionError("Cannot ship before payment") - 状态切换不靠 if-else,而是由当前状态类返回新状态实例:
return PaidState(order)
示例片段:
class PendingPaymentState(OrderState):
def pay(self, order: Order) -> OrderState:
order.update_payment_time()
return PaidState(order)
def cancel(self, order: Order) -> OrderState:
order.mark_as_canceled()
return CanceledState(order)
订单类怎么持有并委托状态行为
订单类本身不存状态字符串,只持有一个 self._state: OrderState 实例,并把所有状态相关操作委托过去。重点在于:状态变更必须通过状态类返回的新实例完成,而不是在订单里直接赋值。
- 禁止写
self._state = "shipped"或self.status = ShippedState() - 必须写
self._state = self._state.ship(self),让当前状态决定能否执行、执行后变成谁 - 订单对外暴露的方法如
order.ship()内部只是转发:return self._state.ship(self) - 构造订单时传入初始状态类实例:
self._state = PendingPaymentState(self)
这样做的好处是:加日志、做审计、拦截非法调用,全在状态类内部控制,订单类保持干净。
真实项目中容易忽略的三个细节
状态模式不是套个模板就完事。实际落地时,这几个点最容易出问题:
- 数据库持久化:状态类是瞬时对象,订单落库时仍需存一个字段(如
status_code)。加载时根据该字段重建对应状态实例,别忘了在状态类里提供from_db_value()类方法 - 并发安全:多个线程/请求同时调用
order.ship(),可能造成状态覆盖。必须在订单方法里加锁,或用数据库行锁+乐观锁(比如更新时校验旧status_code) - 状态迁移图要显式建模:画出所有合法转移路径(如
Paid → Shipped → Confirmed),并在单元测试里遍历每条路径断言结果。漏掉一条边,就可能在线上遇到未定义行为
最麻烦的从来不是写状态类,而是确保状态流转边界被完整描述、持久化一致、并发受控——这些地方没约束,模式反而会掩盖问题。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











