直接在 Eloquent 模型中用 getAttribute 处理状态子机构会出错，因 accessor 调用时关联可能未加载导致空对象访问；应改用 relationLoaded 判断+懒加载兜底，或预加载关联；复用状态机需通过构造参数传入字段名并缓存实例避免重复创建。
为什么直接在 Eloquent 模型里用 getAttribute 处理状态子机构会出错
因为 Laravel 的访问器（accessor）机制和 Eloquent 的属性延迟加载逻辑冲突——getAttribute 在模型未完全初始化、或关系尚未加载时被调用，$this->relation 可能为 null，导致 “Trying to get property 'xxx' of non-object” 错误。更隐蔽的问题是：状态子机构（如订单的支付状态机、发货状态机）往往依赖关联模型（payment、shipment），而这些关联默认不预加载。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 永远避免在
getAttribute中直接访问未保证已加载的关联，改用$this->relationLoaded('payment')显式判断 - 把状态子机构的计算逻辑封装成独立方法（如
getPaymentStateAttribute()），并在该方法内做懒加载兜底：public function getPaymentStateAttribute() { if (!$this->relationLoaded('payment') && $this->payment_id) { $this->load('payment'); } return $this->payment?->state ?? 'pending'; } - 若需高频读取，优先在查询时用
with(['payment', 'shipment'])预加载，而非依赖运行时加载
如何复用同一个状态机类给多个子机构（比如 payment_state 和 shipment_state）
关键不是“继承状态机”，而是让状态机实例能绑定到不同上下文。Laravel 自带的 spatie/laravel-model-states 支持多字段，但默认只认 state 字段；要支持 payment_state、shipment_state 等，必须手动指定字段名并隔离状态转换逻辑。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 定义状态机类时，**不硬编码字段名**，而是通过构造参数传入：
class PaymentStateMachine extends StateMachine { public function __construct(Model $model, string $field = 'payment_state') { parent::__construct($model, $field); } } - 在模型中分别声明两个访问器，各自 new 不同实例：
public function getPaymentStateAttribute() { return app(PaymentStateMachine::class, ['model' => $this])->current(); } public function getShipmentStateAttribute() { return app(ShipmentStateMachine::class, ['model' => $this])->current(); } - 注意：不要在访问器里 new 实例后立刻调用
transitionTo()——那会破坏状态一致性；状态变更应走显式服务方法（如markAsPaid()）
transitionTo 报错 “Cannot transition from null” 怎么定位
这个错误通常不是状态机本身问题，而是底层字段值为 null 或空字符串，而状态机配置里没定义 initial 状态，或初始值没被正确写入数据库。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查数据库该字段是否允许
NULL：如果是，要么设默认值（DEFAULT 'pending'），要么在模型boot()里强制初始化：protected static function boot() { parent::boot(); static::creating(fn ($model) => $model->payment_state = $model->payment_state ?: 'pending'); } - 确认状态机类里
$initial属性是否匹配数据库实际值（大小写、下划线都要一致） - 用
php artisan tinker手动测试：$order = Order::find(123); $order->payment_state; // 看是不是 null 或 '' app(PaymentStateMachine::class, ['model' => $order])->canTransitionTo('paid'); // 返回 false？说明当前值不合法
性能隐患：每次 getAttribute 都 new 一个状态机实例
状态机内部可能包含状态图解析、事件监听器注册等开销，频繁实例化会拖慢响应。尤其在列表页循环渲染时，getPaymentStateAttribute 被调用几十次，就等于创建几十个状态机对象。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在模型里加私有属性缓存实例，按字段名区分：
private array $stateMachines = []; public function getPaymentStateAttribute() { $key = 'payment_state'; if (!isset($this->stateMachines[$key])) { $this->stateMachines[$key] = app(PaymentStateMachine::class, ['model' => $this]); } return $this->stateMachines[$key]->current(); } - 如果使用 Laravel 10+，可配合
memoizetrait（需自行实现或引用laravel-memoize包），但注意缓存生命周期仅限单次请求 - 更彻底的优化：把状态展示逻辑移到前端或 DTO 层，模型只负责存储和变更，不承担状态推导职责
selectRaw 加 CASE WHEN 预计算字段，或者提前聚合好状态视图。 
