Nginx边缘节点需通过proxy_cache_methods精准控制缓存的HTTP方法，默认仅GET/HEAD；若缓存POST，须同时满足：定义cache区、绑定cache区、声明方法；还需定制cache_key防污染，并确保响应头、状态码符合缓存条件。

要让 Nginx 边缘节点只对特定 HTTP 方法启用缓存，关键不是“开启缓存”，而是**精准控制哪些请求能进入缓存流程**。默认情况下，Nginx 仅缓存 GET 和 HEAD 请求，其他方法（如 POST、PUT、DELETE）即使配置了 proxy_cache，也不会被缓存——除非你显式修改 proxy_cache_methods。

明确支持的请求方法并声明

该指令必须与 proxy_cache 在同一作用域（location 或 server 块内），且不能单独存在。例如，若只想缓存 GET 和 HEAD：

• proxy_cache edge;
• proxy_cache_methods GET HEAD;

若需支持 POST（需额外条件，见下文），写法为：

• proxy_cache_methods GET HEAD POST;

POST 缓存必须满足三个前提

允许 POST 进入缓存不是加一行配置就能生效的事，它依赖三要素同时成立：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• 已定义缓存区：proxy_cache_path 在 http 块中声明（如 keys_zone=post_cache:10m）
• 已绑定缓存区：proxy_cache post_cache; 在 location 中启用
• 已声明方法：proxy_cache_methods GET HEAD POST;

缺一不可，否则 POST 请求始终绕过缓存。

为非幂等请求设计可区分的 cache_key

URI 相同的 POST 请求，若共用默认 key（如 $scheme$host$request_uri），会导致缓存污染。必须引入请求体或参数特征：

• JSON 类型（≤1KB）：proxy_cache_key "$scheme$request_method$host$request_uri$request_body";（需确保 proxy_request_buffering on）
• 表单类请求：将参数转为 query 字符串后使用 $args，例如 proxy_cache_key "$scheme$request_method$host$request_uri$args";
• 更可靠方式：由上游服务返回唯一标识头（如 X-Post-Hash），再拼入 key：proxy_cache_key "$scheme$request_method$host$request_uri$upstream_http_x_post_hash";

确保响应本身可缓存

即使请求进了缓存流程，Nginx 仍会检查响应头是否允许缓存。常见拦截项包括：

• 响应含 Set-Cookie 头 → 默认不缓存（可用 proxy_ignore_headers Set-Cookie 覆盖，但需评估业务风险）
• 响应含 Cache-Control: no-cache 或 private → 默认跳过缓存（可用 proxy_ignore_headers Cache-Control 强制忽略）
• 状态码未在 proxy_cache_valid 中声明 → 不缓存（如 POST 返回 201，默认不缓存，需显式加 proxy_cache_valid 201 1m;）