ThinkPHP中response()->json()默认状态码为200，需链式调用->code()设置非200状态码，且必须return整个链式表达式才能生效；漏return会导致响应体为空或Content-Type错误。
ThinkPHP中response()门面返回JSON数据必须链式调用json()和code()
直接用response()->json($data)不会自动设状态码，它默认是200，但如果你需要400、401、500等非200响应，必须显式加->code(400)。很多人写了response()->json($data)->code(400)却没生效，是因为漏了return——这整个链式调用必须作为控制器方法的return值，否则框架不接管输出。
常见错误现象：Content-Type: text/html、响应体是空、浏览器下载文件、前端收到Unexpected token 。
-
response()是门面，本质调用think\Response类，它不自动触发发送逻辑，必须return - 不能混用
json()助手函数和response()门面：比如return response()->json($data);✅，但return json($data);和response()->json($data)混在同一个方法里容易导致头信息冲突 -
response()->json($data)默认不带charset=utf-8，某些老版TP6.x会因此被前端解析为text/plain；稳妥做法是补全->header(['Content-Type' => 'application/json; charset=utf-8']) - 如果项目已全局配置
'default_return_type' => 'json'，再用response()->json()可能重复设置类型，反而引发Header already sent
response()->json()和json()助手函数的区别在哪
核心差异在生命周期介入点和封装粒度：json()是顶层快捷入口，自动处理编码、状态码、头信息，适合90%的API场景；response()->json()更底层，适合需要精细控制响应流（比如加自定义中间件钩子、动态追加头、复用Response实例）的少数情况。
使用场景上：json($data, 422, ['X-RateLimit-Remaining' => '10'])一行搞定；而response()->json($data)->code(422)->header([...])适合在中间件或基类里做统一包装。
立即学习“PHP免费学习笔记（深入）”；
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
-
json()在TP6中默认启用JSON_UNESCAPED_UNICODE，中文不转义；response()->json()不自动加这个选项，需手动传JSON_UNESCAPED_UNICODE给第三个参数 -
json($data, $code, $header, $options)支持全部四个参数；response()->json($data)只接收$data，其余靠链式方法补全 - TP5.1的
json()是立即echo+exit，TP6+全是返回Response对象，所以两者在异常流程、中间件兼容性上行为一致，但response()门面写法在TP5.1里根本不存在 - 性能无实质差别，但
json()少一次对象构造和方法调用，微乎其微
为什么response()->json($data)->send()会报错
因为send()是底层发送方法，它会立即输出并结束脚本，但ThinkPHP的响应生命周期由App::run()统一调度，手动send()会破坏中间件链、日志记录、Trace输出等机制，极大概率触发headers already sent或空白页。
正确做法永远是return response()->json($data)->code(401);，让框架在最后阶段自动调用send()。
- 一旦调用了
->send()，后续任何return都无效，控制器方法还没执行完就中断了 - 调试时如果看到“Cannot modify header information”，八成是某处写了
->send()或提前echo/var_dump - 某些旧教程教“
response()->json(...)->send(); exit;”，这是TP5时代的写法，在TP6+中已过时且危险 - 想立刻终止？用
throw new HttpResponseException(response()->json(...));，这是TP6官方推荐的中断方式
中文乱码、BOM头、Unexpected token问题怎么一次性排查
这些问题几乎都指向同一根源：响应体开头混入了不可见字符。不是代码逻辑错，而是编辑器/编码/错误输出导致JSON结构被污染。
最有效排查顺序是：检查文件编码 → 关闭调试模式 → 检查前置输出 → 验证请求头。
- 所有PHP文件（尤其是
app/、config/、route/目录下）必须保存为UTF-8 无 BOM，BOM头（EF BB BF）会导致Unexpected token -
app_debug => true时，Notice级错误（如访问未定义数组键）会直接输出到响应体开头，关掉debug或用@抑制，或统一用isset()/??判空 - 控制器方法顶部不能有
echo、var_dump、空行、注释前空格；连config/app.php里return [前面都不能有多余空行 - 用
curl -v http://localhost/api/test看原始响应头和体，比浏览器开发者工具更真实；重点看第一行是不是{，如果不是，说明有隐藏输出
base_controller.php构造方法里不小心写的dump()。 
