Laravel中无法设置Cache-Control header问题求助

以下是针对你遇到问题的排查方向和解决方案：

1. 中间件执行顺序问题 #

Laravel中间件按注册顺序执行，若你的缓存头设置中间件在StartSession之后运行，会被该中间件默认设置的Cache-Control: no-cache, private覆盖。

解决方法：
在app/Http/Kernel.php的web中间件组中，将你的SetCacheHeaders中间件移至\Illuminate\Session\Middleware\StartSession::class之前，确保缓存头设置逻辑先执行。

2. 响应类型判断范围过窄 #

你的自定义中间件仅判断了Illuminate\Http\Response类型，但Laravel的响应还包括JsonResponse、RedirectResponse等子类，这些类型的响应不会被处理。

修改后的中间件代码：

class SetCacheHeaders
{
    public function handle(Request $request, Closure $next): Response
    {
        $response = $next($request);

        // 覆盖所有Symfony响应类型（Laravel响应均继承此类）
        if ($response instanceof \Symfony\Component\HttpFoundation\Response) {
            $response->header('Cache-Control', 'public, max-age=7200');
            $response->setEtag(md5($response->getContent()));
        }

        return $response;
    }
}

3. Forge环境的额外配置干扰 #

PHP-FPM配置检查 #

虽然你修改了php.ini中的session.cache_limiter，但Laravel Forge使用的PHP-FPM可能在单独的配置文件（如/etc/php/{version}/fpm/php-fpm.d/www.conf）中设置了php_value[session.cache_limiter]，需确保该值为空。

Nginx配置检查 #

若Nginx配置中存在add_header Cache-Control ...指令，会和Laravel返回的响应头叠加，导致出现两个Cache-Control头。需删除Nginx中额外的缓存头设置，让Laravel完全控制响应头。

4. 浏览器缓存干扰 #

测试时需开启浏览器开发者工具的「禁用缓存」选项，或使用Ctrl+F5强制刷新，避免读取浏览器缓存的旧响应头。

5. Laravel内置cache.headers中间件的使用注意 #

若使用内置中间件，需确保路由未被web中间件组的StartSession覆盖。可尝试将目标路由移出web组，或调整中间件顺序，让cache.headers在StartSession之前执行：

Route::get('/your-route', [YourController::class, 'method'])
    ->middleware([
        \App\Http\Middleware\SetCacheHeaders::class,
        'cache.headers:public;max_age=7200;etag',
        'web' // 确保web组在缓存中间件之后
    ]);

内容的提问来源于stack exchange，提问作者domiQ