如何配置 Nginx 缓存来缓存 POST 请求的响应-Nginx-PHP中文网

nginx 默认不缓存 post 请求，但可安全启用：需配置 proxy_cache_methods 包含 get head post、自定义 proxy_cache_key 含 $request_body 或签名头、显式设置 proxy_cache_valid 支持 200/201 状态码。

如何配置 nginx 缓存来缓存 post 请求的响应

Nginx 默认不缓存 POST 请求，因为这类请求通常具有副作用（如提交数据、修改状态），直接缓存可能引发重复执行、数据错乱或安全问题。但如果你确认某个 POST 接口是幂等、只读、无用户私有数据的（比如搜索 API、GraphQL 查询、参数复杂的表单查询），就可以安全启用其响应缓存。

关键不是“能不能开”，而是“怎么开得稳、分得清、控得住”。

显式允许 POST 方法参与缓存
在 location 块中加入：
```
proxy_cache_methods GET HEAD POST;
```
注意：仅写 POST 不够，必须包含 GET 和 HEAD（Nginx 要求至少两个方法）；该指令需放在启用 proxy_cache 的上下文中。
自定义 cache key，确保不同 POST 内容不混用
默认 key（如 $scheme$proxy_host$request_uri）对所有 POST 请求都一样，会导致缓存污染。应加入能区分请求体的变量：
```
proxy_cache_key "$scheme$proxy_host$request_uri$args$request_body";
```
⚠️ 前提：$request_body 必须可用——需保证 client_max_body_size 合理、proxy_buffering on（默认开启）、且请求体未被流式读取跳过。

更稳妥替代方案（推荐用于生产）：
- 让后端将请求参数签名后写入自定义 header（如 X-Req-Sign: abc123），再在 key 中使用 $http_x_req_sign；
- 或改用 GET + query string（语义清晰、Nginx 原生支持、调试简单）。
明确声明可缓存的状态码与有效期

Nginx Hosting
通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载
```
proxy_cache_valid 200 201 60s;
```
如果 POST 返回的是 200 OK，就必须在这里显式覆盖，否则即使加了 POST 方法也不会缓存。

忽略干扰响应头
后端若返回 Cache-Control: no-cache 或 Set-Cookie，Nginx 默认跳过缓存。如你已确认安全，可忽略：
```
proxy_ignore_headers Cache-Control Expires Set-Cookie;
```
启用 stale 策略提升并发体验
防止多个相同 POST 请求同时穿透回源：
```
proxy_cache_use_stale updating;
```

限制缓存范围，避免误伤
不要在 location / 全局启用，而应精准匹配路径：

location /api/search {
    proxy_cache my_cache;
    proxy_cache_methods GET HEAD POST;
    # …其他配置
}

禁用含敏感信息的请求缓存
自动排除带 Cookie 或认证头的请求：
```
proxy_no_cache $http_cookie $http_authorization;
```

添加响应头便于观察：
```
add_header X-Cache-Status $upstream_cache_status always;
```
成功缓存后，响应头会出现 X-Cache-Status: HIT。
使用 curl 多次调用同一 POST 请求：
```
curl -X POST -d '{"q":"nginx"}' -H "Content-Type: application/json" http://your.site/api/search
```
观察：
→ 响应时间明显下降；
→ 后端 access log 中只记录第一次请求；
→ Nginx error log 无 cache lock 相关警告（说明 proxy_cache_lock 配置合理）。

不复杂但容易忽略。