proxy_cache_purge 是实现 Nginx 缓存精准删除最直接有效的方式，需依赖第三方模块 ngx_http_proxy_cache_purge_module，关键在于 cache key 与 purge 请求 URI 严格一致，并通过 allow/deny 限制访问权限。
要实现 Nginx 中缓存的精准删除，proxy_cache_purge 是最直接有效的方式，但它不是 Nginx 开源版原生支持的功能，需依赖第三方模块 ngx_http_proxy_cache_purge_module（通常随 OpenResty 或手动编译安装）。
确认模块已启用
执行 nginx -V 2>&1 | grep -o with-http-cache-purge-module，若输出为空，说明未编译该模块。常见解决方式包括：
- 使用 OpenResty（默认集成 purge 模块）
- 从源码重新编译 Nginx，添加
--add-module=../ngx_http_proxy_cache_purge - 检查配置中是否误启用了其他同名但不兼容的 purge 补丁
配置 cache key 与 purge 规则对齐
purge 能否精准命中，关键在于 proxy_cache_key 和 purge 请求的 URI 是否严格一致。例如：
proxy_cache_key $scheme$host$request_uri;
对应 purge 请求应为：curl -X PURGE http://example.com/path?arg=val。注意以下细节：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- GET 参数顺序、大小写、编码必须完全相同（如
?a=1&b=2≠?b=2&a=1） - 避免在 key 中使用动态变量（如
$cookie_xxx），否则 purge 无法覆盖所有变体 - 若需按 Host 或其他维度 purge，key 中需显式包含，且 purge 请求需带对应 Host 头
启用 purge 指令并限制访问权限
在 location 块中启用 purge，并仅允许可信来源调用：
location ~ /purge(/.*) {
allow 127.0.0.1;
allow 192.168.1.0/24;
deny all;
proxy_cache_purge cache_name $scheme$host$1$is_args$args;
}
说明：
-
$1匹配/purge/xxx中的xxx，确保 purge 目标路径准确 -
$is_args$args保留原始请求参数，避免因参数丢失导致 key 不匹配 - 务必加
allow/deny控制，防止缓存被恶意清空
验证 purge 是否生效
操作后需验证实际效果，而非仅看响应状态码：
- 首次访问目标 URL，响应头含
X-Cache: MISS（说明缓存未命中） - 再次访问，响应头变为
X-Cache: HIT（缓存已建立） - 执行 purge 后再访问，应再次出现
MISS，且proxy_cache_valid设置未被绕过 - 检查
proxy_cache_path对应目录下对应 hash 文件是否被真实删除（路径可由md5($scheme$host$request_uri)推算）
不复杂但容易忽略：purge 是“按 key 删除”，不是“按 URL 删除”；只要 key 构造逻辑和 purge 请求 URI 完全一致，就能精准清除——关键在统一、可预测、无歧义。
