return 'hello' 触发HTML响应流程,设Content-Type: text/html;return json($data) 触发JSON响应链路,自动设Content-Type: application/json、禁用缓存,并序列化数据;两者底层行为完全不同,类型不匹配会导致fetch().json()抛SyntaxError。

return 'hello' 和 return json($data) 的底层行为完全不同
前者走的是「视图响应」默认流程,后者触发的是「JSON 响应」完整链路。TP 默认把 return 字符串当 HTML 内容处理,自动设 Content-Type: text/html;而 json() 不仅序列化数组,还会强制设置 Content-Type: application/json,并禁用缓存(Cache-Control: no-cache, private)。不匹配的类型会导致前端 fetch().json() 直接抛 SyntaxError: Unexpected token <。
控制器里直接 return 数组,在 TP5.1 和 TP6 行为不一致
TP5.1 中 return ['code' => 0] 等价于 echo 'Array',浏览器看到纯文本;TP6 在满足条件时会自动转 JSON,但前提是:
– 请求头带 Accept: application/json(Postman 默认不带,axios 默认带)
– 没在之前调用过 response()->xxx() 或 Response::create()
– 返回值不是 Closure、resource 等不可序列化类型
漏掉任一条件,TP6 也会退化成输出 Array 文本。
response()->json() 必须显式调用 send() 才真正发出响应
很多人在中间件或命令行脚本里写 response()->json(['msg' => 'ok']) 却收不到响应体,因为 TP6 的 response() 只构建对象,不自动发送。
– 在控制器方法中 return response()->json(...) 是安全的,框架会接管并调用 send()
– 在中间件、Command 类、钩子函数里,必须手动加 ->send()
– 调用 send() 后再 echo 或 var_dump(),会立刻触发 headers already sent 错误
– json() 助手函数内部已调用 send() 并 exit,不能链式调用 code() 等方法
状态码和自定义 Header 容易被覆盖或失效
return json($data) 固定返回 200,想设 400/500 必须改用 response()->json($data)->code(400),且 code() 必须在 json() 之后——顺序反了无效。
– header('HTTP/1.1 400 Bad Request') 与 TP 的 Response 对象冲突,会被忽略
– 自定义 Header 如 X-TP-Version,TP5.1 用 ->header(['X-TP-Version' => '5.1']),TP6 用 ->withHeader('X-TP-Version', '6'),混用会报错
– 所有提前输出(文件末尾空格、中间件里的 dump()、日志驱动输出 HTML 注释)都会导致 header 失效,状态码和 JSON 结构全乱
立即学习“PHP免费学习笔记(深入)”;



















