怎么配置 proxy_cache_methods 允许对 POST 请求进行结果缓存优化-Nginx-PHP中文网

nginx 缓存 post 响应需四条件齐备：proxy_cache_methods 显式包含 post（至少两个方法）、proxy_cache_key 包含 $request_body 以区分请求体、proxy_cache_valid 显式配置 200 等状态码有效期、仅在幂等路径下精准启用。

怎么配置 proxy_cache_methods 允许对 post 请求进行结果缓存优化

要让 Nginx 对 POST 请求的响应做结果缓存优化，不能只改 proxy_cache_methods —— 它只是“允许入口”，真正生效需要四点齐备：方法放行、缓存键唯一、响应可缓存、作用范围精准。

必须同时满足这四个条件，缺一不可

proxy_cache_methods GET HEAD POST;
必须显式列出 POST（且不能只写 POST，Nginx 要求至少两个方法）
这条指令本身不启用缓存，只告诉 Nginx “POST 响应可以参与缓存流程”
proxy_cache_key 必须能区分不同请求体
默认 key（如 $scheme$host$request_uri）对所有 POST 都一样，会导致缓存污染
推荐写法（适用于 JSON 查询类接口）：
proxy_cache_key "$scheme$request_method$host$request_uri$args$request_body";
⚠️ 注意：$request_body 依赖 proxy_buffering on; 和足够大的 client_max_body_size（如 1m），否则可能为空
proxy_cache_valid 显式覆盖状态码和有效期
Nginx 默认不缓存 200 响应（除非后端返回 Cache-Control: public）
必须加：proxy_cache_valid 200 201 30s;（根据业务设 10–300 秒较稳妥）

仅在明确幂等的路径下启用，例如：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

location /api/search {
    proxy_cache my_cache;
    proxy_cache_methods GET HEAD POST;
    proxy_cache_key "$scheme$request_method$host$request_uri$args$request_body";
    proxy_cache_valid 200 10s;
    proxy_ignore_headers Cache-Control Set-Cookie;
    proxy_no_cache $http_cookie $http_authorization;
    add_header X-Cache-Status $upstream_cache_status;
}

额外建议提升安全与稳定性