thinkphp中response()->header()设置cache-control常失效，因默认response类不触发缓存逻辑；应优先选用json()、view()等具体响应方法并链式调用header()或更可靠的setcache()方法。
response()->header() 设置 Cache-Control 失效？先确认响应类型
直接调用 response()->header('Cache-Control', 'max-age=3600') 在多数场景下不会生效，因为 ThinkPHP 的 response() 默认返回的是 Response 基类实例，它不自动设置 Content-Type，也不触发缓存头的默认逻辑。真正起作用的是具体响应子类，比如 json()、view()、html() 等——它们内部已预设了合适的 Content-Type 和基础缓存策略。
所以第一步不是硬塞 header，而是选对响应构造方式：
- 返回 JSON 数据：用
json($data)->header('Cache-Control', 'public, max-age=300') - 返回 HTML 页面：用
view('index')->header('Cache-Control', 'private, max-age=60') - 返回纯文本或自定义内容：必须显式指定类型，例如
response($content)->contentType('text/plain')->header('Cache-Control', 'no-cache')
为什么 setCache() 方法比手动 header() 更可靠
Response 类提供了 setCache() 方法（注意不是 cache()，后者是控制器页面缓存），它是专为 HTTP 缓存头设计的封装，会同时设置 Cache-Control、Expires 和 Last-Modified（可选），且自动适配不同响应类型的行为逻辑。
例如：
return json($data)->setCache([
'max_age' => 300,
's_maxage' => 600,
'public' => true,
]);
这行代码等价于手动设置：
Cache-Control: public, max-age=300, s-maxage=600-
Expires自动计算为当前时间 + 300 秒（GMT 格式）
而自己写 header() 或 header() 风格的 header() 调用，容易漏掉 Expires 或格式错误（如时区不对），导致浏览器行为不一致。
带 Cookie 的接口不能用 *，Access-Control-Allow-Origin 必须动态匹配
如果你在设置缓存头的同时还启用了跨域（比如前端带 credentials: 'include'），那么 Access-Control-Allow-Origin 就不能是 *，否则浏览器直接拒绝响应，连缓存头都看不到。
正确做法是动态读取请求头中的 Origin，并只允许白名单内的域名：
$origin = $request->header('Origin');
$allowed = ['https://admin.example.com', 'https://app.example.com'];
if ($origin && in_array($origin, $allowed)) {
$response->header('Access-Control-Allow-Origin', $origin);
$response->header('Access-Control-Allow-Credentials', 'true');
}
注意：Access-Control-Allow-Credentials: true 和 Access-Control-Allow-Origin: * 是互斥的，只要写了前者，后者就必须是具体域名。
开发环境关掉模板缓存，否则改了 header 看不到效果
很多人在控制器里加了 ->header() 或 ->setCache()，但浏览器始终返回旧的 Cache-Control 值——大概率是因为开启了模板缓存（'template_cache' => true），导致整个 HTML 响应被文件缓存下来，header 设置根本没走到输出阶段。
检查 config/template.php 中是否包含：
'cache' => env('template_cache', false), // 开发时务必为 false
另外，Swoole 或 Workerman 环境下，header() 函数本身无效，必须统一走 $response->header() 链式调用，这点容易被忽略。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
