ThinkPHP6.0中必须通过Response对象设置响应头，禁用原生header()；推荐用json()或response()返回并链式调用header()、contentType()等快捷方法，API需显式使用json()确保JSON头，跨域等通用头宜在中间件中统一配置。
ThinkPHP6.0 中配置响应头信息必须通过 Response 对象操作，不能使用原生 header() 函数——框架会忽略它，甚至导致 JSON 格式损坏或 500 错误。
用 json() 或 response() 统一设置头信息
推荐在控制器中直接返回带头的响应对象：
return json($data)->header('Cache-Control', 'no-cache');return response($html)->contentType('text/html')->header('X-Powered-By', 'TP6');- 批量设置可用关联数组：
->header(['Content-Type' => 'application/json; charset=utf-8', 'Access-Control-Allow-Origin' => '*'])
常用响应头的快捷方法
Response 类内置多个语义化方法，比手动写 header() 更安全、不易出错：
-
contentType('application/json; charset=utf-8')—— 强制指定类型与编码（JSON 中文不乱码的关键） -
cacheControl('no-store')—— 设置缓存策略 -
lastModified(strtotime('-1 hour'))—— 设置 Last-Modified 时间戳 -
eTag(md5($data))—— 设置 ETag 值用于协商缓存 -
expires('+1 day')—— 设置过期时间
API 接口必须显式声明 JSON 头
仅靠前端发 Accept: application/json 不足以让 TP6 返回 JSON；若控制器里只写 return $data; 或 return ['msg' => 'ok'];，框架可能走 HTML 渲染流程，返回空白或模板错误。
- 正确做法：一律用
return json($data);（自动设好Content-Type: application/json; charset=utf-8） - 如需自定义状态码和头：
return json($data, 201)->header('X-Status', 'created'); - 避免混用：
json(json_encode(...))会导致双重编码，前端解析失败
全局默认头配置（谨慎使用）
不建议全局硬编码响应头，但可在中间件中统一处理跨域等通用需求：
- 新建中间件
app/middleware/AllowCrossDomain.php - 在
handle()方法末尾加：return $response->header(['Access-Control-Allow-Origin' => '*', 'Access-Control-Allow-Methods' => 'GET,POST,PUT,DELETE,OPTIONS']); - 在
app/middleware.php中注册为全局中间件或路由分组中间件
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
