Response类是“响应蓝图”而非输出工具，仅组装状态码、头信息等部件，send()方法才触发HTTP输出；json()后调code()才生效，因json()初始化流程并重置状态码为200。
Response类不是“输出工具”，而是“响应蓝图”
很多人一看到response()->json()就以为它立刻把数据打到浏览器，其实不是。Response类在 ThinkPHP 里不负责即时输出，只负责组装响应的各个部件：状态码、头信息、原始数据、类型、编码方式。真正触发 HTTP 输出的是send()方法——它在public/index.php末尾被调用，或由框架在控制器return后自动补上。
这意味着：
-
response()->json(['a'=>1])只是生成一个待发送的对象，没调send()就不会有 HTTP 响应体 - 中间件里用
response()必须自己加->send()，否则静默失效 -
send()内部会检查headers_sent()，一旦已有输出（空格、BOM、echo），就会报“headers already sent”
status code 设置顺序很关键：code() 必须在 json() 之后
response()->code(400)->json($data) ❌ 不生效；response()->json($data)->code(400) ✅ 才对。原因在源码里：json()方法内部已调用$this->type('json')并初始化响应流程，此时code()才能写入底层$this->code属性；反过来调，code()先设值，但json()执行时又把状态码重置为默认200。
快捷函数如json($data, 400)也无效——它本质是response()->json($data)->send()，没留链式调用空间，第二个参数被直接忽略。
立即学习“PHP免费学习笔记（深入）”；
所以实际编码中：
- 需要自定义状态码时，一律用
response()->json($data)->code(4xx)形式 - 不要混用
http_response_code(400)或header('HTTP/1.1 400 Bad Request')，Response 对象会接管 header，手动设可能冲突 - 异常场景下（比如验证失败抛
ValidateException），状态码由异常处理器统一设置，控制器里设code()可能被覆盖
getContent() 和 getStatusCode() 是调试关键入口
想确认当前Response对象到底长什么样？别猜，用这两个方法：
-
$response->getContent()返回最终要输出的字符串（比如{"code":0,"data":{}}），还没 send 也能取到 -
$response->getStatusCode()返回当前设置的状态码，注意：它只有在send()前读才准；若在控制器里刚->code(400)就立刻getStatusCode()，仍可能是200（因为 send 尚未触发） - 统计状态码必须放在中间件
handle()结尾、或think\ResponseSend事件里，不能放控制器里
XML 和 raw 类型最容易踩 Content-Type 坑
response()->xml($data)和response()->raw($str)不会自动设对Content-Type，而json()会自动设application/json; charset=utf-8。
常见翻车点：
-
response()->xml($data)返回乱码或被浏览器当 HTML 解析 → 必须显式->header('Content-Type', 'application/xml; charset=utf-8') -
response()->raw(json_encode($data))返回text/html导致fetch().json()失败 → 改成->contentType('application/json; charset=utf-8') -
xml()对数组结构敏感：数字开头键名（如0 => 'x'）、含:或空格的键，会被跳过或报错；要用@id写属性，根节点名需显式传参
源码里Response::send()对不同$type分支处理逻辑差异很大，看懂switch ($type)那段，比死记文档更管用。
