Nginx默认不缓存POST请求，需显式配置proxy_cache_methods POST并自定义proxy_cache_key包含$request_body，同时确保proxy_cache_valid覆盖对应状态码、忽略禁用缓存的响应头，并启用proxy_cache_use_stale等配套策略。
默认情况下，Nginx 只缓存 GET 和 HEAD 请求的响应，POST 请求不会被缓存。若需对 POST 请求的响应做边缘缓存（例如表单提交后返回的结构化结果、搜索接口等），必须显式启用并精细控制缓存键。
启用 POST 缓存需配置 proxy_cache_methods
在 http、server 或 location 块中添加：
-
proxy_cache_methods POST;—— 允许缓存 POST 请求的响应 - 可叠加其他方法，如
proxy_cache_methods GET HEAD POST; - 注意：仅声明该指令还不够，还需确保
proxy_cache_valid明确覆盖 POST 返回的状态码（如200）
必须自定义 cache key 区分不同 POST 内容
默认缓存键（$scheme$proxy_host$request_uri）对所有 POST 请求都一样，会导致不同请求体共用同一缓存项。需用 $request_body 参与生成唯一 key：
proxy_cache_key "$scheme$proxy_host$request_uri$request_body";- 注意：
$request_body在某些场景下可能为空（如请求体过大被缓冲到临时文件），建议配合client_max_body_size和proxy_buffering on确保其可用 - 若接口带 query 参数，也建议加入
$args，例如："$scheme$proxy_host$request_uri$args$request_body"
配套关键配置不可遗漏
单独开启 POST 缓存容易出错，需同步检查以下几项：
-
proxy_cache_valid 200 5m;—— 明确为 POST 返回的 200 响应设置有效期 -
proxy_cache_use_stale updating;—— 避免高并发时多个请求同时回源 -
proxy_ignore_headers Cache-Control Expires Set-Cookie;—— 若后端返回了Cache-Control: no-cache或Set-Cookie，默认会禁用缓存；按需忽略这些响应头 - 确保
proxy_cache已指定有效 keys_zone，且proxy_cache_path已正确定义（含use_temp_path=off提升稳定性）
验证与调试建议
上线前建议通过日志和响应头确认行为是否符合预期：
- 添加响应头：
add_header X-Cache-Status $upstream_cache_status;，观察是否出现HIT或MISS - 用
curl -X POST -d '{"q":"a"}' -H "Content-Type: application/json" http://your-domain/多次调用，检查响应时间是否下降、后端访问日志是否减少 - 注意：含敏感信息或用户私有数据的 POST 响应不应缓存，务必评估业务语义与数据一致性
