Nginx 缓存怎么使用 proxy_cache_methods 扩展支持 POST 缓存-Nginx-PHP中文网

要让nginx缓存post请求，必须同时满足四个条件：显式声明proxy_cache_methods包含post；在http块定义proxy_cache_path并启用proxy_cache；逐状态码设置proxy_cache_valid；用$request_body或其哈希构造唯一proxy_cache_key。

nginx 缓存怎么使用 proxy_cache_methods 扩展支持 post 缓存

要让 Nginx 缓存 POST 请求，proxy_cache_methods 是第一步，但只是“放行开关”，不能单独起作用。必须同时满足四个硬性条件，缺一不可。

必须显式声明 POST 方法

默认只允许 GET 和 HEAD，POST 被直接拦截在缓存流程之外。需在 location 或 server 块中写明：

proxy_cache_methods GET HEAD POST;
如果还要缓存 OPTIONS（如 CORS 预检），可追加：proxy_cache_methods GET HEAD POST OPTIONS;

必须定义并启用缓存区

仅声明方法没用，Nginx 还不知道往哪儿存、用哪块内存管理元数据：

CPA Update - Secure CLI Proxy API Maintenance

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

下载

在 http 块中提前定义缓存路径与共享内存区：
proxy_cache_path /var/cache/nginx/post_cache levels=1:2 keys_zone=post_cache:10m max_size=500m inactive=60m use_temp_path=off;
在对应 location 中启用它：
proxy_cache post_cache;

必须设置明确的缓存有效期

POST 响应不会继承 proxy_cache_valid any，必须按状态码逐条指定：

proxy_cache_valid 200 201 204 60s;（常见成功响应）
避免写 any，否则可能意外缓存 4xx/5xx 错误响应

必须构造区分请求体的缓存键

所有 POST 共用一个 key 就会互相覆盖。关键是要把请求体或关键参数纳入计算：

启用请求体读取：proxy_buffering on; 且确保 client_max_body_size 足够大
推荐 key 写法：
proxy_cache_key "$scheme$request_method$host$request_uri$args$request_body";
若请求体过大或含敏感内容，可用哈希替代：
proxy_cache_key "$scheme$request_method$host$request_uri$args$md5($request_body)";

不复杂但容易忽略：少一个环节，POST 就永远不会进缓存。调试时可用 add_header X-Cache-Status $upstream_cache_status; 验证是否命中。