启用 fastcgi_cache 需三处协同：1. http 块定义 cache_path；2. 设计含 $args 的稳定 cache_key；3. location 中配置 cache、ignore_headers、cache_valid 及 bypass 规则，缺一将导致 x-cache 显示 bypass 或 miss。
设置 `fastcgi_cache` 不是加一行指令就完事，关键在三处协同：缓存区域定义、缓存键设计、响应头过滤。漏掉任何一环，X-Cache 都会显示 BYPASS 或始终 MISS。
1. 在 http 块中定义缓存路径和内存区
必须放在 http{} 大括号内、所有 server{} 之前，且路径需真实存在、权限正确：
- 执行命令创建目录：
sudo mkdir -p /www/server/nginx/cache/fastcgi - 赋权给 Nginx 工作用户（宝塔默认是
www）：sudo chown -R www:www /www/server/nginx/cache/fastcgi - 在
/www/server/nginx/conf/nginx.conf的http {下插入：
说明：keys_zone=fcgi 是后续引用的名称；256m 指内存中存放 key 的空间，日均万级 PHP 请求建议 ≥128m；use_temp_path=off 可减少 I/O 开销。
2. 设计稳定、可区分的缓存键
缓存是否命中，全看 fastcgi_cache_key 是否一致。默认值容易导致误共享或击穿：
- 通用推荐（含查询参数）：
fastcgi_cache_key "$scheme$request_method$host$request_uri$is_args$args"; - WordPress 等需区分搜索/分页，必须含
$args，否则?s=nginx和?s=cache共用一个缓存 - 切勿包含
$cookie_*或$http_user_agent——除非你明确要做登录态/设备级缓存 - 如需剔除 utm 参数等跟踪字段，用
map预处理$args，不能靠忽略头解决
3. 在 location ~ \.php$ 中启用并控制缓存行为
仅声明 fastcgi_cache fcgi 不够，必须配套设置有效期、忽略干扰头、排除敏感请求：
- 在网站配置的
location ~ \.php$ {块内添加：
fastcgi_cache_valid 200 301 302 15m;
fastcgi_cache_valid 404 1m;
fastcgi_ignore_headers Cache-Control Expires Set-Cookie;
fastcgi_cache_use_stale error timeout http_500;
add_header X-FastCGI-Cache $upstream_cache_status;
重点：fastcgi_ignore_headers 是“开关级”配置——PHP 脚本返回 Cache-Control: no-cache 或 Set-Cookie 时，Nginx 默认直接跳过缓存，此行必须显式禁用才生效。
4. 排除不适宜缓存的请求（按需）
动态站需主动跳过登录用户、后台路径、POST 提交等：
- 在
location ~ \.php$上方添加判断逻辑：
# 后台、登录页、POST 请求不缓存
if ($request_uri ~* "^/(wp-admin|wp-login|zb_system|zb_users|admin)") { set $skip_cache 1; }
if ($request_method = POST) { set $skip_cache 1; }
if ($http_cookie ~* "wordpress_logged_in|PHPSESSID") { set $skip_cache 1; }
再在 location 内追加：fastcgi_cache_bypass $skip_cache; 和 fastcgi_no_cache $skip_cache;
