如何设置 proxy_cache_methods 以实现特定 POST 请求的边缘缓存加速？

本文共计859个文字，预计阅读时间需要4分钟。

在默认情况下，Nginx 和大多数边缘节点（如阿里云 ESA）不支持缓存 POST 请求。这是因为 POST 请求通常具有副作用，例如提交表单、创建资源等。然而，现实中很多 POST 请求是查询类操作（如 GraphQL 查询、搜索 API、带有 JSON body 的条件筛选等），这类请求非常适合缓存。关键在于显式启用缓存并精确控制。

明确启用 POST 缓存的必要配置

仅靠 proxy_cache_methods GET HEAD POST; 不够，必须同步满足以下三点：

• 开启缓存区：在 location 或 server 块中声明 proxy_cache my_cache;（对应 http 块中已定义的 proxy_cache_path）
• 允许 POST 方法：设置 proxy_cache_methods GET HEAD POST;（PUT/DELETE 极少用，暂不建议）
• 设计唯一缓存键：必须包含请求体内容，否则所有 POST 都会命中同一缓存项。