nginx对post请求启用边缘缓存需满足三条件：启用缓存区、响应头含cache-control或覆盖忽略、proxy_cache_valid显式声明状态码；cache_key必须包含请求体或哈希以确保唯一性；须按location精细化配置并实测hit。
直接开启 POST 路径缓存不可行——Nginx 默认禁止缓存 POST 请求，且“路径缓存”本身不是标准概念。真正要做的是：在明确业务幂等性的前提下，对特定 POST 接口启用边缘缓存，核心是让相同请求（含 URL + 方法 + 请求体）命中同一缓存条目。
必须满足的三个硬性条件
仅写 proxy_cache_methods POST 不会生效，必须同时确保：
- 已启用缓存区：
proxy_cache my_cache;（对应http块中已定义proxy_cache_path） - 响应头携带可缓存标识：后端需返回
Cache-Control: public, max-age=60或Expires；若后端无法控制，用proxy_ignore_headers Cache-Control Expires覆盖 - 状态码被
proxy_cache_valid显式覆盖：例如proxy_cache_valid 200 201 30s;，否则 200 响应默认不缓存
关键：构造唯一且安全的 cache_key
默认 key 不包含请求体，所有 POST 同路径会共用一个缓存项，导致数据错乱。必须显式引入区分因子：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 基础写法（适合小文本 body）：
proxy_cache_key "$scheme$request_method$host$request_uri$args$request_body"; - 更稳妥写法（防 body 为空）：
proxy_cache_key "$scheme$request_method$host$request_uri$args$arg_q$arg_f";（提取关键 query 参数） - 高阶写法（需 OpenResty/Lua）：用
$request_body_md5或 SHA-256 哈希代替原始 body，避免大 body 拷贝开销
⚠️ 注意：$request_body 依赖 proxy_buffering on; 和足够大的 client_max_body_size，否则可能为空。
按路径精细化控制缓存行为
不要全局放开 POST 缓存，应在具体 location 中配置：
- 搜索类接口（幂等）：
location /api/search { ... proxy_cache_valid 200 10s; proxy_cache_lock on; } - 字典查询类（低频更新）：
location /api/dict/batch { ... proxy_cache_valid 200 5m; proxy_ignore_headers Cache-Control; } - 禁用高风险路径：
location /api/order/submit { proxy_no_cache $request_method; }
验证是否真正生效
光看配置没用，要实测：
- 加响应头：
add_header X-Cache-Status $upstream_cache_status;，响应中出现HIT才算成功 - 用 curl 多次发送相同 POST 请求：
curl -X POST -d '{"q":"test"}' http://example.com/api/search - 检查后端 access log —— 只有首次请求应记录，后续应无日志输出
