toArray中未出现$appends字段，因该属性必须声明为public；若设为protected或遗漏声明，Laravel将静默忽略；且需确保访问器命名规范（如getFullNameAttribute对应full_name），并注意$hidden、casts及N+1查询风险。
toArray 里加的字段没出现？检查 $appends 是否声明为 public
Laravel 模型中通过 $appends 添加的虚拟属性，必须是 public 属性，否则 toArray() 和 API 响应里完全不会包含它。常见错误是把它写成 protected $appends 或漏掉声明——Laravel 不报错，但字段直接静默消失。
-
$appends必须是 public，且值为字符串数组，例如：public $appends = ['full_name']; - 对应访问器方法名必须是
getXXXAttribute()格式（驼峰转下划线），比如full_name对应getFullNameAttribute() - 如果模型用了
casts或$hidden，会覆盖$appends效果：被$hidden列出的字段，即使在$appends里也会被过滤掉
想让某些字段只在 API 返回时追加？别硬塞 $appends，用 makeVisible()
$appends 是全局生效的，一旦设了，所有 toArray()、toJson()、Eloquent 序列化都会带上。但实际开发中，往往只需要在 API 响应里加字段，后台管理或队列任务里并不需要——这时候硬塞 $appends 会污染数据逻辑。
- 更干净的做法：保持
$appends = []空着，在控制器里按需显式暴露：$user->makeVisible(['full_name'])->toArray() -
makeVisible()只影响当前实例，不影响后续操作，也不改变模型定义 - 注意：如果字段本身在
$hidden里，makeVisible()才有效；如果字段本就没被隐藏，这步纯属多余
追加字段依赖关系复杂（比如要查数据库）？别在访问器里写查询
访问器（getXXXAttribute()）在每次调用 toArray() 时都会执行。如果里面写了 User::find() 或 $this->posts()->count() 这类 Eloquent 查询，很容易触发 N+1 问题——100 个用户模型，就多跑 100 次查询。
- 简单计算（如拼接字符串、日期格式化）可以放访问器里
- 涉及关联或聚合查询的，应该提前用
withCount()、withSum()或selectRaw()预加载，再在访问器里直接读取属性，例如：return $this->posts_count . ' 篇文章'; - 实在绕不开动态查询，考虑改用资源类（
Resource）封装，把逻辑收口到响应层，而不是塞进模型
JSON API 中字段名要 snake_case，但访问器返回 camelCase？别手动转换字段名
Laravel 默认把访问器名（getFullnameAttribute）转成小写下划线（full_name）输出，这是由 asJson() 和序列化器控制的。如果你发现字段名变成 fullname 或 FullName，大概率是命名不规范或用了自定义序列化器。
- 确保访问器方法名严格符合 Laravel 规范：
getFullnameAttribute()→ 输出fullname；getFullNameAttribute()→ 输出full_name - 不要在访问器里 return 数组或对象，除非你同时重写了
toArray()；否则 JSON 里会嵌套一层或报错 - 如果项目启用了
snake_case全局序列化（比如用了spatie/laravel-json-api），单独一个字段不一致，优先检查是否被中间件或资源类二次处理了
最常被忽略的是：访问器里的逻辑在模型生命周期里是“无上下文”的——它不知道当前请求是 API 还是命令行，也不知道有没有预加载关联。一旦开始在里面做条件判断或查询，就很难测试和复用。把复杂逻辑往外推，比往模型里塞更稳妥。
