Laravel API Resource加载多对多关联时报Call to a member function first() on null错误

问题核心是User模型存在配置重名冲突：你在$casts属性里将roles设置为array类型转换，和roles()多对多关联方法同名了。

Laravel模型读取属性时，类型转换的优先级高于关联关系读取。当你在API资源中调用$this->whenLoaded('roles')时，框架会优先匹配$casts中的roles配置，尝试读取模型表中名为roles的字段做数组转换。但你的用户表根本没有roles字段，转换得到的结果是null，将null传入RoleResource::collection()后，就会触发Call to a member function first() on null的报错。

你之前直接打印User::with('roles')->get()结果正常，是因为with()预加载确实将关联数据存入了模型的关联存储数组，但同名的cast配置拦截了资源层对关联的读取，才会出现你调试时看到的两次CollectsResources调用：第一次传入正常的预加载关联数据，第二次传入cast转换得到的null值。

• 推荐方案：直接删除User模型$casts数组中的'roles' => 'array'配置。你的roles是多对多关联关系，不是数据库存储的JSON字段，本身不需要做数组类型转换，删除这行后框架会正常读取关联数据，报错立刻消失。
• 备选方案：如果你有特殊业务需求必须保留roles字段的数组转换（不推荐，同名配置会大幅提升后续维护的bug概率），可以修改多对多关联的方法名避开冲突，比如将关联方法从roles()改为userRoles()，同步修改Controller中的with('userRoles')预加载逻辑、UserResource中的whenLoaded('userRoles')判断即可。

内容的提问来源于stack exchange，提问作者Bulent