ThinkPHP5响应输出需显式声明类型、避免前置输出、禁用default_return_type配置；控制器必须return json()等响应对象，不可echo/die；非控制器场景须调用send()。
ThinkPHP5 的响应输出不是“写完 return 就完事”，关键在于明确输出类型、避免隐式依赖配置、防止 headers already sent。直接 echo 或 die 会破坏框架响应流程，导致状态码失效、Header 丢失、JSON 格式错乱等问题。
控制器里 return json() 为什么有时不生效？
常见错误是 return 语句被前置输出干扰，比如在 return 前调用了 echo、var_dump()、print_r()，或开启了调试模式但没关输出缓冲。TP5 不会捕获这些输出，而是直接触发 headers already sent 错误，后续的 JSON Header（如 Content-Type: application/json）就发不出去。
- 确保
return json($data)是控制器方法中最后一个可执行语句，前面不能有任何输出 - 不要在控制器里用
exit或die终止流程，改用HttpResponseException - 若需调试，用
Log::info()或断点，别用dump()直接输出到页面 -
json()默认状态码是 200，要改状态码必须链式调用->code(401)或传第二个参数：json($data, 401)
default_return_type 配置到底要不要设？
设了反而容易出问题——它只对“裸 return 数组/字符串”起作用，而一旦你用了 json()、view() 等快捷方法，该配置就完全被忽略。很多人设了 'default_return_type' => 'json' 后发现部分接口返回 HTML，就是因为在某些控制器里忘了显式调用 json()，结果框架按默认规则 fallback 到 HTML 渲染。
- 建议禁用全局 default_return_type，保持为
'html'（默认值），强制每个接口显式声明输出类型 - AJAX 接口统一用
return json($data)，页面跳转用return redirect('/login')，模板渲染用return view('index') - 如果项目全是 API，可在基类控制器里封装一个
apiReturn()方法，内部固定调用json()并加统一字段（如code、msg）
jsonp() 能不能在视图里拼？
不能。视图（.html 或 .php 模板）无法控制 HTTP 头、无法校验 callback 参数、容易混入 BOM 或空白字符，前端会报 callback is not defined 或语法错误。
立即学习“PHP免费学习笔记（深入）”；
- JSONP 必须由控制器直接输出，用
return jsonp($data)—— 它自动设置Content-Type: application/javascript、白名单校验callback参数、包裹 JSON 数据 - 若 callback 字段名不是默认的
callback（比如叫cb），用jsonp($data, ['callback' => 'cb']) - 需要自定义状态码或 Header（如跨域头），不能依赖
jsonp()默认行为，得手动构造：Response::jsonp($data)->code(400)->header(['Access-Control-Allow-Origin' => '*'])->send()
非控制器上下文怎么输出响应？
中间件、事件监听器、命令行指令里，框架不会自动调用 send()，你 return 一个 Response 对象也没用，浏览器收不到任何内容。
- 必须显式调用
->send()，例如：response()->json(['error' => 'timeout'])->code(504)->send() -
send()后不能再有任何输出，包括echo、Log::debug()（除非日志写文件，不输出到 stdout） - 若需 send 后继续执行（比如记录日志），把
send()放在逻辑分支末尾，并确认前面无任何输出缓冲（可用ob_get_level() === 0检查） - 命令行场景下，
send()会输出 HTTP 头，可能污染终端显示，此时应改用echo json_encode($data)并退出进程
最易被忽略的是：控制器里看似正常的 return，只要前面有任意一行输出（哪怕只是空格、BOM、print_r($x, true) 忘了加第二个参数），就会让整个响应退化为纯文本，状态码和 Header 全部失效。检查时优先看 PHP 错误日志里的 headers already sent 提示，而不是前端看到的 JSON 格式是否“看起来对”。
