Nginx 中 proxy_cache_purge 怎么清理过期缓存文件-Nginx-PHP中文网

proxy_cache_purge仅精确匹配key删除缓存，不判断是否过期；真正清理过期缓存需依赖inactive机制、proxy_cache_use_stale及谨慎的系统级find清理。

nginx 中 proxy_cache_purge 怎么清理过期缓存文件

proxy_cache_purge 不能清理“过期”的缓存文件，它只做精确键匹配的主动删除——无论该缓存是否过期、是否还在有效期内、甚至是否根本不存在，只要 key 对得上，就删；对不上，就静默失败。

换句话说：
✅ 它清理的是“你指定的 URL 对应的缓存条目”；
❌ 它不扫描、不判断、不自动识别哪些文件已过期；
❌ 它和 proxy_cache_valid、Expires、Cache-Control 等过期逻辑完全无关。

为什么 purge 不等于“清过期”？

Nginx 的缓存过期是逻辑过期（logical expiration）：

响应头带 Cache-Control: max-age=300，或配置了 proxy_cache_valid 200 5m；
5 分钟后，下次请求来时，Nginx 会认为这个缓存“该重新校验了”，但文件仍留在磁盘上；
它不会自动删，除非触发 inactive 机制（比如 1 小时没被访问），或你手动 purge。

所以，“过期缓存文件”在 Nginx 里其实长期“尸位素餐”，purge 只是你喊它“点名清除”，不是系统自动“扫墓”。

想真正清理过期缓存？得靠组合策略

✅ 设置 `inactive` 时间（最可靠、原生支持）

在 proxy_cache_path 中指定：

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=mycache:10m inactive=30m max_size=2g;

表示：30 分钟内没被任何请求命中的缓存文件，会被 worker 进程自动 unlink 删除（物理清理）；
这是唯一由 Nginx 自动执行的磁盘清理机制，无需模块、无需脚本、无需重启。

⚠️ 注意：inactive 判定依据是最后访问时间（atime），不是创建时间或过期时间。哪怕缓存已逻辑过期 2 小时，只要刚被 hit 过，就不会被删。

FastAPI Flask Proxy
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

✅ 配合 `proxy_cache_use_stale updating` 减少回源冲击

proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

当缓存过期且正在后台更新时，仍可返回旧内容，避免大量请求同时击穿回源。

✅ 用 `proxy_cache_purge` 主动清理特定资源（精准可控）

例如清掉某个文章页及其带参变体：

location ~ ^/purge(/.*)$ {
    allow 127.0.0.1;
    allow 192.168.10.0/24;
    deny all;
    proxy_cache_purge mycache "$scheme$request_method$host$1$is_args$args";
}

调用方式：

curl -X PURGE https://example.com/purge/article/123
curl -X PURGE "https://example.com/purge/article/123?utm_source=mail"

关键：$scheme$request_method$host$1$is_args$args 必须和你 proxy_cache_key 完全一致，否则 purge 失效。

✅ 补充：系统级定时清理（慎用）

若 inactive 不够用（比如缓存命中极低，但又不想等太久），可用 find 清理陈旧文件：

# 先测试（不删）
find /var/cache/nginx -type f -mmin +60 -print | head -20

# 确认无误后执行（建议加到 cron，且避开业务高峰）
find /var/cache/nginx -type f -mmin +60 -delete

⚠️ 风险提示：

mtime 是修改时间，不一定反映缓存生命周期；
强制删可能删掉刚写入还没被 worker 收录的临时文件；
更安全的做法是让 inactive 承担主力，find 仅作兜底。

常见误区提醒

❌ 不存在 purger on 或 proxy_cache_path ... purger=on 这类指令 —— Nginx 官方无此参数，配置会报错；
❌ max_size 触发的是 LRU 回收（按访问时间淘汰），不是按“是否过期”清理；
❌ PURGE 返回 200 ≠ 缓存已被删，可能是 key 不匹配、缓存不存在、或权限拒绝，务必验证响应头 X-Cache-Status 或查缓存目录；
❌ 直接 rm -rf /var/cache/nginx/* 风险极高，可能导致 worker 访问已删文件，出现 502 或日志警告。