全局响应宏必须在appserviceprovider::boot()中注册，使用response::macro()定义，闭包内通过$this调用response()构建器，不可依赖自动注入的$request或$response，且需避免与原生方法同名。
怎么注册一个全局可用的 Response 宏
Laravel 的 Response 宏必须在服务提供者中注册，且只能在应用启动早期完成——错过时机（比如在控制器里调用）会直接报错 BadMethodCallException: Method ... does not exist。最稳妥的位置是 AppServiceProvider::boot()，因为此时容器已就绪，Response facade 也能正常绑定到实际类。
- 宏注册代码必须放在
boot()方法内，不能放register() - 使用
Response::macro('name', function() { ... })，闭包内用$this可访问原始响应构建逻辑 - 宏名不能与现有
Response方法冲突（如json、view），否则会被静默覆盖或触发报错 - 如果宏依赖其他服务（如
Auth或配置），建议用app()延迟解析，避免启动时容器未完全加载
Response::macro('success', function ($data = [], $message = 'OK', $code = 200) {
return response()->json([
'code' => $code,
'message' => $message,
'data' => $data,
], $code);
});为什么宏里不能直接用 $request 或 $response 对象
Response::macro() 注册的是静态方法，闭包执行时上下文里没有自动注入的 $request 或当前 $response 实例。它不像控制器方法那样由框架自动解析参数。你看到的“能用 $this”仅指代底层 Illuminate\Http\Response 构建器（即 response() 辅助函数返回的对象），不是请求生命周期中的响应实例。
- 宏本质是给
Responsefacade 添加静态可调用行为，不是中间件或控制器钩子 - 若需读取请求信息（如
accept头判断返回 JSON 还是视图），得手动通过request()辅助函数获取，不能依赖自动注入 - 宏里调用
response()->json(...)是安全的，但不要试图在宏里写return response()->...->send()，这会中断响应流程，导致重复输出或 headers already sent 错误
Response 宏和 API 资源类（Resource）的区别在哪
Response 宏适合封装固定结构的响应体（比如统一的 {code, message, data} 格式），而 Resource 类专注数据转换：把 Eloquent 模型转成数组/JSON，不处理状态码、headers、响应类型等 HTTP 层细节。
- 宏返回的是完整
Illuminate\Http\Response实例，可链式调用header()、withCookie()等 -
Resource必须配合response()->json((new UserResource($user))->resolve())才能生成响应，单独 new 不产生 HTTP 输出 - 同一个业务场景下，宏 + Resource 经常组合使用：宏负责外层结构和状态码，Resource 负责
data字段的精细序列化 - 宏无法做条件性数据展开（比如根据请求参数决定是否包含关系），那是
Resource的职责；硬塞进宏会导致逻辑臃肿、难以测试
本地开发能用，线上 500 报错？检查这个点
常见原因是宏注册时机受环境影响：有些团队把宏注册逻辑写在了 routes/web.php 或某个按需加载的配置文件里，而 Laravel 在生产环境默认开启路由缓存（php artisan route:cache），导致这些文件根本不会被执行，宏自然失效。
- 运行
php artisan route:cache后，所有路由定义以外的 PHP 代码（包括宏注册）都不会运行 - 解决办法只有一条：确保宏注册 严格限定在
AppServiceProvider::boot()中，这是唯一被保证在缓存/非缓存模式下都会执行的位置 - 部署后记得清缓存：
php artisan config:clear && php artisan cache:clear，否则旧的容器绑定可能残留
宏本身不复杂，难的是意识到它是个“启动期一次性行为”，而不是随用随注册的工具函数。一旦注册位置错了，问题往往只在特定环境暴露，排查起来容易绕远。
