资源类处理空值需控制器判空兜底；Laravel 10+需显式调用response()恢复分页；关联字段须预加载防N+1；字段映射优先用模型访问器+appends。
资源类返回空数组或 null 怎么办
资源类默认只处理非空、可迭代的数据，传入 null 或空集合时，ResourceCollection 会静默返回空数组，JsonResource 则直接报错 Call to a member function toArray() on null。
实操建议：
- 在控制器里先做判空，用三元或空合并操作符兜底：
return new UserResource($user ?? new User())，或者更安全地用optional($user)->toArray() - 若接口允许「无数据」语义，显式返回
response()->json(null, 200)，别依赖资源类自动处理null - 自定义资源基类可重写
toArray()前加判空逻辑，但不推荐——职责应由调用方控制
Laravel 10+ 中 ResourceCollection 自动分页失效
升级后发现 ResourceCollection 不再自动识别 Paginator 实例，返回的 JSON 缺少 links 和 meta 字段，只剩原始数据数组。
原因在于 Laravel 10 默认关闭了自动包装：底层 ResourceResponse 不再对 Paginator 调用 withResponse() 方法。
实操建议：
- 显式使用
CollectionResource::collection($users)->response()（注意末尾->response()） - 或改用静态构造：
UserResource::collection($users)->additional(['meta' => [...]])，再手动->response() - 检查是否误用了
new UserResource($users)—— 这是单资源写法，对集合会丢掉分页信息
资源类里访问模型关系字段报 N+1
资源类中写 $this->relation->name 看似简洁，但没预加载时，每个资源实例都会触发一次 SQL 查询，100 条数据就是 100 次查询。
这不是资源类的问题，而是 Eloquent 加载时机问题：资源类执行时，模型已从数据库取出，但关联未加载。
实操建议：
- 控制器中必须预加载：
User::with('posts', 'profile')->get()，不能指望资源类自己load() - 避免在
toArray()里调用$this->load(...)—— 它是运行时加载，仍会 N+1 - 如需条件性加载（比如只对管理员显示敏感关系），用
whenLoaded('relation')，它只取已加载过的数据，不触发新查询
API 资源返回字段和数据库字段名不一致怎么映射
前端要 user_name，模型里是 name；要 is_active，模型是 active。硬编码改 key 易出错，也破坏资源类复用性。
最稳的方式不是在 toArray() 里手写键名，而是用访问器 + 隐藏字段组合。
实操建议：
- 在模型中定义访问器：
getUserNameAttribute()，然后在资源里直接写'user_name' => $this->user_name - 配合
$appends和$hidden控制输出：protected $appends = ['user_name']; protected $hidden = ['name']; - 如果只是临时映射（比如某接口专用），用
array_merge()手动重组，但别在资源类里做复杂逻辑——那该交给 DTO 或 Presenter
资源类本质是视图层，它不该承担字段转换规则的维护成本；映射逻辑越靠近模型或独立服务，越容易测试和复用。
