Nginx 中怎么使用 Location 匹配特定的 HTTP 请求方法-Nginx-PHP中文网

Nginx不支持在location路径匹配中直接按HTTP方法（如GET/POST）区分，但可通过if指令结合$request_method变量实现方法控制，推荐多分支场景使用map指令提升效率与可维护性。

nginx 中怎么使用 location 匹配特定的 http 请求方法

Nginx 本身不支持在 location 块中直接根据 HTTP 请求方法（如 GET、POST、DELETE 等）进行匹配。也就是说，你不能写类似 location GET /api/ { ... } 这样的语法。但可以通过 if 指令结合 $request_method 变量，在 location 内部做条件判断，实现按请求方法分流或限制。

用 if 判断 $request_method 实现方法控制

这是最常用且官方支持的方式。注意：if 只能在 server 或 location 块中使用，且应避免在 location 外滥用（Nginx 官方文档明确指出 if 在某些上下文中有风险，但在方法判断场景下是安全的）。

使用 $request_method 获取当前请求方法，值为全大写字符串（如 GET、POST、PUT、DELETE）
配合 if 做精确匹配，再执行 return、deny、proxy_pass 等动作
示例：只允许 GET 和 HEAD 访问静态资源目录

location /static/ {
    if ($request_method !~ ^(GET|HEAD)$) {
        return 405;
    }
    # 正常处理静态文件
    root /var/www;
}

对特定方法做特殊处理（如拦截 POST）

常见于 API 接口保护或调试场景，比如禁止某路径接收 POST 请求，或把 PUT 请求重定向到后端特定服务。

可嵌套多个 if，但建议用 map 提升可读性（见下一点）
注意：不要在 if 中使用 proxy_pass 以外的复杂指令（如 rewrite 后再 proxy_pass），可能引发变量失效
示例：将所有 DELETE 请求返回自定义响应

location /api/users/ {
    if ($request_method = DELETE) {
        return 200 '{"status":"deleted"}';
    }
    proxy_pass http://backend;
}

用 map 预定义方法路由规则（推荐用于多方法分支）

当需要根据方法做多种不同处理时，map 指令比层层 if 更清晰、高效，且在配置加载时就完成映射，无运行时开销。

Nginx Hosting

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

下载

在 http 块中定义 map，将 $request_method 映射为变量（如 $method_route）
在 location 中通过该变量控制行为，例如选择不同 proxy_pass 地址或启用不同限流策略
示例：按方法分发到不同后端

http {
    map $request_method $backend_url {
        GET     http://read-svc;
        POST    http://write-svc;
        PUT     http://write-svc;
        DELETE  http://write-svc;
        default http://read-svc;
    }
<pre class="brush:php;toolbar:false;">server {
    location /api/ {
        proxy_pass $backend_url;
    }
}

}