$model->getAttribute('name') 不返回当前 locale 值，因该方法直接读取原始字段（如 JSON 字符串或数组），不执行 locale 切换逻辑；需通过 accessor（如 getTitleAttribute）显式提取 $this->attributes['name'][$locale] 并设 fallback。
为什么 $model->getAttribute('name') 在多语言场景下不返回当前 locale 的值
因为 Eloquent 默认不感知 locale，getAttribute() 拿的是原始字段值（比如 JSON 字符串或带 locale 键的数组），不是自动翻译后的结果。你看到的 "name" 可能是 {"en": "Apple", "zh": "苹果"}，而不是当前 app()->getLocale() 对应的 "苹果"。
常见错误现象：前端调用 $post->title 显示整段 JSON；或者手动写 $post->title[app()->getLocale()] 但没做空值判断，导致 Undefined array key 报错。
- 必须显式定义访问器（accessor）来封装 locale 切换逻辑
- 避免在模型外重复写
[app()->getLocale()]，否则 locale 变更后容易漏改 - 如果字段是数据库 JSON 类型，需配合
$casts = ['name' => 'array']，否则取出来是字符串，无法直接下标访问
怎么用 getAttribute + getTranslatedAttribute 统一处理本地化字段
不要覆盖 getAttribute() 全局行为（会破坏 Eloquent 内部逻辑），而是针对具体字段加 accessor。例如字段名是 title_translations，对应多语言内容：
protected $casts = [
'title_translations' => 'array',
];
public function getTitleAttribute()
{
$locale = app()->getLocale();
$translations = $this->attributes['title_translations'] ?? [];
return $translations[$locale] ?? ($translations['en'] ?? '');
}
这样 $post->title 就自动返回当前 locale 的值，fallback 到 en，再 fallback 到空字符串。
立即学习“PHP免费学习笔记（深入）”；
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 务必检查
$this->attributes而非$this->title_translations，避免触发 getter 递归调用 - 如果用的是 Laravel 9+ 和 MySQL JSON 字段，
cast必须设为'array'，不能是'json'（后者返回stdClass） - 若 locale 是动态传入（如 API 请求头指定），建议把 locale 提取为参数，而不是硬绑
app()->getLocale()
如何让 toArray() 和 API 响应也自动本地化
toArray() 默认不会走 accessor，所以即使写了 getTitleAttribute()，$post->toArray()['title'] 还是原始 JSON。要修复它，得重写 toArray() 或用 $appends：
protected $appends = ['title']; // 然后确保 getTitleAttribute() 已定义（见上一节） // 这样 toArray()、toJson()、API Resource 都会包含本地化后的 title
但注意：$appends 会让字段始终存在，哪怕数据库里是 null —— 如果你希望只在有翻译时才输出，就得在 accessor 里控制返回 null，并配合 hidden 或 Resource 中的条件逻辑。
- 别在
$appends里加未定义 accessor 的字段，会报Call to undefined method - 如果字段需要支持编辑（比如 Form Request 提交），记得同时写
setTitleAttribute()，把单语言值存进对应 locale 键 - 使用
ApiResource时，优先在 Resource 的toArray()里做翻译，比模型层更灵活（比如不同接口用不同 fallback 策略）
为什么 where('title_translations->en', 'Apple') 查询失败
MySQL JSON 查询语法敏感：Laravel 的 where() 不会自动加引号，->en 实际生成 SQL 是 title_translations->'$.en'（注意单引号）。但如果你写成 ->en，MySQL 会当成列名解析，报错 Unknown column 'en'。
正确写法必须用字符串形式，并注意 JSON 路径语法：
// ✅ 正确
Post::where('title_translations->$.en', 'Apple')->get();
// ❌ 错误（少 $.）
Post::where('title_translations->en', 'Apple')->get();
// ✅ 更安全：用 whereJsonContains（Laravel 8.76+）
Post::whereJsonContains('title_translations', ['en' => 'Apple'])->get();
- SQLite 不支持
->操作符，开发环境用 SQLite 会直接报错，必须切到 MySQL/PG 测试 - JSON 字段无法建传统索引，大数据量时
whereJsonContains性能较差，必要时得冗余一个title_en字段单独索引 - PostgreSQL 用
->>（文本提取）而非->（JSON 提取），Laravel 的语法不兼容，得用 raw 查询
JSON 类型，或忘了在 fillable 里放开翻译字段，导致批量赋值时静默丢弃。 
