thinkphp中设置json响应状态码必须在json()后调用code()，如return response()->json($data)->code(400)；若先code()再json()则无效，因json()已锁定状态码。
ThinkPHP中response()->json()链式调用code()必须在后
直接写 return response()->json($data)->code(400) 是对的，但反过来写 return response()->code(400)->json($data) 就无效——因为 json() 内部已触发响应初始化，后续 code() 调用被忽略。这不是 bug，是设计使然：ThinkPHP 的 Response 对象在 json() 执行时就锁定了状态码，code() 只能作为收尾动作。
常见错误现象：
- 前端始终收到
200 OK，哪怕你写了->code(401) - 中间件里提前输出了空格或
echo，导致headers already sent，状态码根本发不出 - 在控制器构造函数里调用了
response()，此时请求还没进业务逻辑，code()设置早于实际响应生成
json() 助手函数支持状态码参数，但不支持响应头链式操作
return json($data, 400) 是合法且推荐的写法，它等价于 response()->json($data)->code(400)->send()，一步到位。但注意它不接受第三个参数传 header 数组；如果要加自定义头（比如 X-Request-ID），必须退回到 response() 对象方式：
return response()->json(['msg' => 'forbidden'])->code(403)->header(['X-Request-ID' => $id]);
性能影响很小，但多一次对象创建；若项目中大量需要带 header 的 JSON 响应，建议封装一个助手函数统一处理。
全局设 default_return_type 后，return $data 会自动转 JSON，但状态码仍需手动干预
在 config/app.php 中设了 'default_return_type' => 'json'，控制器里写 return ['code' => 0] 确实会自动 JSON 化并设 Content-Type: application/json，但 HTTP 状态码永远是 200 —— 框架不会根据数组里的 code 字段自动映射状态码。
所以这类写法依然要显式控制状态码：
- ✅
return json(['code' => 1], 400) - ✅
return response()->json(['code' => 1])->code(400) - ❌
return ['code' => 1]; // 状态码仍是 200
中间件里记录状态码，别依赖 $response->getCode() 获取最终值
ThinkPHP 的中间件在 handle() 方法里拿到的 $response 对象，其 getCode() 返回的是当前对象持有的状态码，但未必是最终发出的值——比如后面有异常处理器覆盖了状态码（如抛出 HttpException(404)），而中间件已执行完毕。
更稳妥的做法是在「响应发送前」钩子中捕获，例如重写 Response 类的 send() 方法，或者使用框架提供的 response_send 事件（TP6.1+）：
Event::listen('response_send', function ($response) {
Log::info('status_sent', ['code' => $response->getCode()]);
});
否则容易统计到“中间态”状态码，比如日志里看到一堆 200，但 Nginx access log 里却是 500。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
