要让Nginx对特定POST请求启用代理缓存，需同时配置proxy_cache_methods、缓存键（含$request_body或关键参数）、忽略响应头、限定作用路径，并验证HIT状态。
要让 Nginx 对特定 POST 请求启用代理缓存，不能只改 proxy_cache_methods 就完事。它只是必要条件之一，必须和缓存键设计、响应控制、路径限制、幂等性判断一起配合，才能安全、稳定、有效生效。
必须显式声明并限定作用范围
默认情况下，Nginx 只缓存 GET 和 HEAD 请求。开启 POST 缓存的第一步是在目标 location 块中写明：
-
proxy_cache_methods POST;或更常见的是proxy_cache_methods GET HEAD POST; - 但不要放在全局 server 或 http 块里——应严格限定在明确幂等的路径下，例如：
location /api/search { ... }或location /graphql { ... } - 对下单、登录、上传等有副作用的路径，用
proxy_no_cache $request_method;或正则匹配直接禁用
缓存键必须区分不同请求体
同一个 URL 的 POST 请求，因 body 不同，响应很可能不同。若缓存键不包含 body 或关键参数，所有 POST 都会挤进同一个缓存槽，造成响应错乱。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 推荐写法（适用于 JSON 查询类接口）：
proxy_cache_key "$scheme$request_method$host$request_uri$args$request_body"; - 若 body 较大或含二进制内容，改用哈希或提取关键字段：
proxy_cache_key "$scheme$request_method$host$request_uri$arg_q$arg_sort"; - 确保
client_body_buffer_size足够（如 128k～256k），并开启proxy_buffering on;，否则$request_body可能为空或截断
响应头与状态码需明确允许缓存
Nginx 默认尊重后端返回的 Cache-Control: no-cache 或 Set-Cookie，这会让缓存自动失效。
- 添加
proxy_ignore_headers Cache-Control Expires Set-Cookie;，强制忽略这些头（仅适用于无用户态、无敏感信息的查询接口） - 用
proxy_cache_valid 200 201 302 10s;明确指定可缓存的状态码和 TTL，避免依赖后端头 - 搭配
proxy_cache_use_stale updating;，防止高并发时多个请求同时穿透回源
验证是否真正生效
上线后别只看配置，要通过实际行为确认：
- 加响应头：
add_header X-Cache-Status $upstream_cache_status;，观察是否出现HIT - 用 curl 多次发相同 POST：
curl -X POST -d '{"q":"nginx"}' http://your.site/api/search
对比响应时间、后端 access log 是否只记录第一次 - 检查 error log 是否有
client intended to send too large body或buffered to a temporary file，这类提示说明 body 未完整进内存，$request_body不可靠
