应使用状态模式而非字符串硬编码：每个状态封装对应行为，通过统一抽象基类约束接口，订单仅持状态实例；非法流转由各状态类主动校验并抛出illegalstatetransitionerror；状态切换逻辑分离为状态类验证+订单类执行；数据库只存状态码，运行时按需实例化。
订单状态类为什么不能用字符串硬编码
直接用 "pending"、"shipped" 这类字符串表示状态，会在条件判断、日志打印、API 返回时反复散落，一旦拼错或新增状态就得全局搜改。更麻烦的是，不同状态下的行为（比如“已支付”才能发货，“已完成”不能再退款）没法绑定到状态本身，逻辑只能堆在订单主类里，越写越臃肿。
状态模式的核心是把每个状态变成一个独立类，让行为和状态一起封装。不是“订单有状态”，而是“订单当前是某个状态对象”，调用 order.ship() 时，实际执行的是 PaidState.ship() 或 CancelledState.ship() 的具体实现。
- 状态类必须统一继承抽象基类（如
OrderState），强制定义所有可响应的方法（pay()、ship()、cancel()） - 订单主类只持有一个
self._state实例，所有状态变更都通过self._state = new_state完成，不暴露内部字段 - 禁止在状态类中访问订单的私有属性（如
self._order._items），需通过订单公开方法传参或回调
如何避免状态流转被非法跳转
用户可能绕过前端限制，直接发 POST /order/123/cancel 请求，而此时订单其实处于 "delivered" 状态——后端若只校验 HTTP 方法和路径，就可能让取消操作误生效。状态模式本身不自动阻止非法流转，得靠每个状态类自己守门。
比如 DeliveredState.cancel() 应该抛出 IllegalStateTransitionError，而不是静默忽略或强行执行。关键点在于：每个状态类只实现它“合法能做的动作”，其余动作要么抛异常，要么返回 False，绝不能默认兜底。
- 不要在
BaseState中为所有方法提供空实现，那会掩盖非法调用 - 异常类型建议自定义（如
class IllegalStateTransitionError(Exception)），便于上层统一捕获并返回 409 Conflict - 数据库更新必须放在状态切换的最后一步，即先验证、再执行业务逻辑、最后持久化新状态，防止中间态残留
transition() 方法该放在订单类还是状态类里
常见误区是把所有流转逻辑（比如“从 pending 到 paid 需要扣减库存、生成流水”）全塞进 PendingState.pay()。这会导致状态类职责过重，且难以复用（比如退款流程也要走“paid → cancelled”，但扣减库存逻辑不该重复写）。
更合理的分法是：状态类只决定“能不能转”，订单类负责“怎么转”。即 order.pay() 是入口，它调用 self._state.validate_payment() 做前置检查，通过后再调用 self._update_inventory()、self._record_payment() 等订单自身方法，最后才调用 self._set_state(PaidState(self))。
-
validate_*类方法放状态类，纯逻辑判断，无副作用 -
_update_*类方法放订单类，含 DB、RPC、缓存等外部依赖 - 状态类构造器接收
order引用仅用于回调（如self.order.notify()），禁止直接修改订单字段
Django/SQLAlchemy 场景下如何持久化状态对象
状态类是内存对象，不能直接存进数据库。常见的错误做法是把状态类名（"PaidState"）存为字符串字段，然后每次从字符串反查类——这既不安全（类名变更即断裂），也无法序列化状态内特有的临时数据（比如 ShippedState 可能缓存了物流单号）。
正确做法是只存状态标识符（如 status_code 字段值为 "paid"），并在订单模型的 @property 或 _state getter 中按需实例化对应状态对象：
@property
def state(self):
return STATE_MAP[self.status_code](self)
其中 STATE_MAP = {"pending": PendingState, "paid": PaidState, ...} 是预定义字典。这样既解耦了持久化与运行时，又避免了反射带来的维护风险。
注意：如果状态类需要保存额外数据（如发货时间），这些字段应作为订单模型的普通字段存在（shipped_at），而非塞进状态对象里——状态对象只是行为载体，不是数据容器。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
