Eloquent Attribute 中不可直接访问未加载关联，应先用 relationLoaded() 判断或改用模型方法；避免在访问器中查询数据库，推荐预加载、cast 或 hasOneThrough 关系实现。
Attribute 访问器里不能直接调用 $this->relation
你写了个 getLearningStatesAttribute，想在里头查关联模型（比如 $this->user->progress），结果报错 Call to a member function progress() on null —— 因为关系未加载，$this->user 是 null。
- 访问器执行时，Eloquent 不保证关联已预加载，哪怕你在查询里写了
with('user')，访问器仍可能早于关联加载时机执行 - 正确做法是用
$this->relationLoaded('user')先判断，再安全取值；或者改用append+accessor组合，但必须配合load()显式触发 - 更稳妥的替代方案：把逻辑移到模型方法（如
learningState()），按需调用，不依赖自动附加
用 HasOneThrough 实现跨表学习状态聚合
如果「学习状态」存在独立表（如 user_lesson_progress），而你想从 Lesson 模型直接拿到某个用户的当前状态，别硬写访问器，该用关系定义。
- 在
Lesson模型里定义：public function userProgress() { return $this->hasOneThrough( UserLessonProgress::class, User::class, 'lesson_id', // lesson 表外键（其实是中间表字段名，注意方向） 'user_id', // user_lesson_progress 表外键 'id', // lesson 表主键 'id' // user 表主键 )->where('user_id', auth()->id()); } - 这样
$lesson->userProgress才真正可预加载、可缓存、可链式过滤 - 访问器做不到这点：它无法参与 Eloquent 的查询构建，纯 PHP 层计算，容易 N+1
避免在 Attribute 里做 DB 查询
常见错误：在 getLearningStatesAttribute 里写 UserLessonProgress::where(...)->first()。
- 每次访问该属性都触发一次查询，模板循环渲染 20 个课程？就是 20 次 DB 请求
- Eloquent Attribute 是「惰性求值」，不缓存结果，也不感知上下文是否已查过相同数据
- 正确路径：用
withCount('userProgress')或withSum('userProgress', 'score')预聚合；或统一用load('userProgress')加载后，在访问器里只做简单判断 - 真要动态查，请明确封装成方法（
freshLearningState()），并加文档说明「此操作会触发查询」
JSON 字段存状态时，Attribute 要防 null 和类型错
如果 learning_states 是 MySQL JSON 字段，直接 json_decode($this->attributes['learning_states']) 很危险。
立即学习“PHP免费学习笔记（深入）”；
- 字段为空字符串、
null、或不是合法 JSON 时，json_decode返回null，后续->completed就报错 - 推荐写法：
protected function getLearningStatesAttribute($value) { if (!is_string($value) || $value === '' || $value === 'null') { return (object) ['status' => 'not_started']; } $decoded = json_decode($value); return $decoded ?: (object) ['status' => 'invalid']; } - 更进一步：用 Laravel 的
casts数组声明'learning_states' => 'object'，框架会自动处理空值和解析异常
