Nginx使用fast_cgi_cache创建缓存时返回空回复的解决方法咨询

以下是几个针对性的解决方案，按优先级尝试：

1. 启用fastcgi_cache_lock避免并发缓存生成 #

当缓存不存在时，多个请求会同时触发后端生成缓存，这可能导致Nginx在缓存文件未完全写入时返回空回复。启用fastcgi_cache_lock后，同一时间仅允许一个请求去后端生成缓存，其余请求等待缓存生成完成后直接读取缓存：

# 在http或server/location块中添加
fastcgi_cache_lock on;
fastcgi_cache_lock_timeout 5s;  # 设置等待超时时间，超时后请求会直接访问后端

2. 检查缓存目录权限 #

Nginx运行用户（通常是www-data或nginx）需要对缓存目录（包括临时目录）拥有完整的读写权限，否则缓存文件生成失败会导致空回复：

# 替换为你的缓存目录路径
chown -R www-data:www-data /var/cache/nginx/fastcgi
chmod -R 700 /var/cache/nginx/fastcgi

3. 调整FastCGI超时与缓存有效期配置 #

如果后端服务响应过慢，Nginx可能在缓存生成完成前就返回空回复。调整相关超时参数，确保后端有足够时间生成响应并写入缓存：

# 在http或server/location块中添加
fastcgi_connect_timeout 30s;
fastcgi_send_timeout 30s;
fastcgi_read_timeout 30s;

# 配置不同响应码的缓存有效期
fastcgi_cache_valid 200 302 1h;
fastcgi_cache_valid 404 1m;

4. 排除干扰缓存的响应头 #

部分后端返回的Cache-Control、Set-Cookie等头部可能干扰Nginx的缓存写入逻辑，可配置忽略这些头部：

fastcgi_ignore_headers Cache-Control Expires Set-Cookie;

5. 检查后端服务状态 #

如果上述配置无效，排查后端服务（如PHP-FPM）是否存在请求堆积或超时问题：

• 调整PHP-FPM的进程池参数（如pm.max_children、pm.start_servers），确保有足够进程处理缓存生成请求
• 查看后端服务日志（如/var/log/php-fpm/www-error.log），确认是否有报错导致无法生成响应

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