在 nginx 中配置 post 请求绕过缓存,核心做法是修改 `proxy_cache` 的指令参数,将 `post` 方法加入忽略列表。具体操作是在 `http`、`server` 或 `location` 块中使用 `proxy_cache_methods get head post;`(默认通常只包含 get/head),或者更常见的是使用 `proxy_no_cache` 配合条件判断来强制不缓存 post 请求。这样做可以确保每次 post 请求都直接转发给后端服务器,避免返回过期的旧数据。

如何配置 proxy_cache_methods 以包含 POST
通过设置 `proxy_cache_methods` 指令并显式添加 `POST`,Nginx 会尝试缓存 POST 响应。但通常我们想要的是“绕过”,即不缓存。如果希望完全绕过,应使用 `proxy_no_cache` 或 `proxy_cache_bypass`。这里演示如何通过 `proxy_cache_methods` 控制哪些方法被缓存,若需绕过则不包含 POST。

server {
listen 80;
server_name example.com;
location /api/ {
# 仅缓存 GET 和 HEAD,POST 请求不会被缓存(即绕过)
proxy_cache_methods GET HEAD;
proxy_pass http://backend;
proxy_cache my_cache;
}
}
上述配置中,`proxy_cache_methods GET HEAD;` 明确指定只有 GET 和 HEAD 方法的响应会被缓存。任何 POST 请求到达时,Nginx 不会查找缓存,也不会存储响应,从而实现了 POST 请求绕过缓存的效果。这是最直接的配置方式。
如何使用 proxy_no_cache 强制不缓存特定请求
除了 `proxy_cache_methods`,还可以使用 `proxy_no_cache` 指令结合 `$request_method` 变量来动态决定是否跳过缓存。这种方法更灵活,可以在同一 location 下对不同方法采取不同策略。

server {
listen 80;
server_name example.com;
location /api/ {
# 如果请求方法是 POST,则不缓存
proxy_no_cache $request_method;
proxy_cache_bypass $request_method;
# 注意:proxy_no_cache 需要配合条件使用,例如:
# proxy_no_cache $is_args $args; // 示例条件
# 更常见的做法是:
if ($request_method = POST) {
proxy_no_cache 1;
proxy_cache_bypass 1;
}
proxy_pass http://backend;
proxy_cache my_cache;
}
}
在上面的代码中,使用了 `if` 块来检查 `$request_method` 是否为 `POST`。如果是,则设置 `proxy_no_cache` 和 `proxy_cache_bypass` 为 1,强制 Nginx 不缓存该请求并直接从后端获取最新数据。这种方式适用于需要更复杂逻辑的场景,比如某些特定的 POST 端点可能需要缓存,而其他则不需要。但请注意,`if` 指令在 Nginx 中需谨慎使用,因为它可能引入意外行为。对于简单的 POST 绕过,推荐使用第一种 `proxy_cache_methods` 方法。
POST 请求绕过缓存后的实际行为验证
当配置生效后,发送一个 POST 请求到 `/api/` 端点,Nginx 将直接代理请求到后端服务器,并返回后端的响应。由于没有缓存参与,每次 POST 请求都会得到最新的后端数据。可以通过查看 Nginx 的访问日志或后端服务器的接收记录来验证这一点。例如,在后端服务器打印请求时间戳,对比多次 POST 请求的时间戳,确认它们都来自后端而非缓存。











