Eloquent 属性协调失败源于 $casts、访问器、序列化逻辑等机制作用域与执行顺序不一致；应优先用 $casts 处理类型转换，访问器仅用于动态计算，JSON 字段需显式标记 dirty 或拆分为关联模型。
PHP 中 Eloquent 的 “Attribute Harmonization” 并不是 Laravel 官方术语，也没有内置机制叫这个名字——它通常是开发者对 get*/set* 访问器、$casts、mutator 和 accessor 混用时引发数据不一致的俗称。真正要解决的是：模型属性在获取、设置、序列化、数据库写入等环节行为不统一导致的冲突。
为什么 getAttribute() 和 toArray() 返回值不一致？
这是最典型的“协调失败”现象：比如一个字段存的是时间戳整数，你加了 getCreatedAtAttribute() 访问器返回 Carbon 实例，但没配 $casts 或没重写 serializeDate()，结果 toArray() 里还是原始数字，而 $model->created_at 是对象——后续 JSON 编码或前端消费就出错。
- 根本原因：Eloquent 对属性的处理分多层——原始值 →
$casts转换 → 访问器介入 → 序列化逻辑再处理 - 关键点：
$casts影响getAttribute()、toArray()、jsonSerialize()三者；而访问器只影响getAttribute()（即点语法取值） - 实操建议：优先用
$casts处理类型转换，仅当需要动态计算或格式化时才用访问器。例如时间字段统一用'created_at' => 'datetime'，别再写getCreatedAtAttribute()返回格式化字符串 - 如果必须用访问器（比如拼接用户名），记得同时覆盖
arrayableAttributes()或在toArray()前手动 unset 冲突字段，避免重复出现
$casts 和 set*/get* 同时存在时谁生效？
顺序决定结果：Eloquent 先走 $casts（设值时反向 cast，取值时正向 cast），再进访问器。也就是说，setPriceAttribute($value) 接收到的 $value 已经是 $casts['price'] 转换后的值（比如从字符串转成 float）。
- 常见错误：把
$casts['price'] = 'float'和setPriceAttribute($value)都写了，又在 mutator 里做floatval($value)—— 重复转换，可能丢失精度或抛异常 - 正确做法：二者选其一。若需单位转换（如存“分”，读“元”），用 mutator；若只是类型修正（字符串数字→整型），用
$casts - 注意布尔字段：Laravel 默认把
'0'/'1'当字符串 cast，不会自动转false/true。要严格布尔语义，得写'active' => 'boolean'，而不是靠setActiveAttribute()手动判断
JSON 字段里的嵌套属性更新失败或被忽略？
当模型有 $casts = ['meta' => 'array']，且你通过 $model->meta['theme'] = 'dark' 修改后调用 $model->save()，Laravel 不会自动检测 meta 数组内部变化——它只监听顶层属性是否被 set，所以变更不会持久化。
立即学习“PHP免费学习笔记（深入）”；
- 根本限制：Eloquent 的变更检测（
isDirty()）不深入数组/对象内部 - 解决方案：显式标记为 dirty，例如
$model->meta = $model->meta;（触发 setter），或直接$model->forceFill(['meta' => $model->meta])->save() - 更稳妥的做法：把 JSON 字段拆成独立模型 + 关联，或改用
jsonb配合原生 SQL 更新（PostgreSQL） - 额外风险：如果
meta字段用了getMetaAttribute()访问器返回新数组，每次取值都生成新引用，$model->meta['theme'] = 'dark'实际修改的是临时数组，完全不影响原始值
真正难处理的从来不是单个机制怎么用，而是不同机制叠加时的隐式执行顺序和作用域边界——比如 $casts 在序列化中生效，但访问器不在；mutator 在赋值时生效，但批量赋值（fill()）可能绕过它。留心这些缝隙，比记住所有 API 更重要。
