如何关闭Laravel API响应中的data外层封装？

本文共计835个文字，预计阅读时间需要4分钟。

在默认情况下，Laravel 的 API 资源（如 `JsonResource` 和 `ResourceCollection`）会将响应数据自动包裹在 `data` 键下。这不是配置项的开关，而是资源类底层的默认行为——您无法通过全局配置一键禁用，必须在资源类内部显式控制。

为什么 withoutWrapping() 不生效？

很多人尝试在控制器或服务提供者里调用 JsonResource::withoutWrapping()，但发现对单个资源实例无效。这是因为该方法只影响 ResourceCollection::collection() 静态调用生成的集合响应，且必须在调用前设置；它对 new UserResource($user) 这类实例化方式完全无作用。

• JsonResource::withoutWrapping() 仅对 UserResource::collection($users) 有效
• 它不改变单个资源实例的 toArray() 行为，也不影响手动 new 的对象
• 若在中间件或控制器中调用，但 collection 方法已在之前执行，就已错过时机

禁用单个资源的 data 包裹

单个资源（如 UserResource）没有内置“取消包裹”机制。它的输出结构完全由 toArray() 返回值决定。