Nginx 的 map 指令可基于 HTTP 方法实现动态访问控制与后端分流：通过映射 $request_method 生成 $allowed_method 或 $upstream_backend 变量，在 location 中用 if 限制方法或 proxy_pass 路由，支持热更新与多条件组合。
利用 Nginx 的 map 指令，可以基于 HTTP 方法（如 GET、POST、PUT、DELETE）实现轻量、高效且可维护的动态访问控制与后端分流，无需修改应用代码或引入额外中间件。
核心原理：用 map 构建方法驱动的变量
map 是 Nginx 的运行时变量映射机制，它根据请求上下文（如 $request_method）动态生成一个新变量。该变量可在后续的 if、proxy_pass、return 等指令中直接使用，实现逻辑分支。
关键点：
– 映射发生在请求处理早期，开销极小；
– 支持正则匹配和精确匹配；
– 变量值可为字符串、数字或空（用于条件跳过）。
实现动态访问权限控制
通过限制特定 HTTP 方法的访问，可快速拦截高风险操作，例如禁止外部直接调用 DELETE 或 PUT 接口：
- 在
http块中定义权限映射：
default "1";
GET "1";
HEAD "1";
POST "1";
DELETE "0";
PUT "0";
PATCH "0";
}
- 在
location中结合if拦截非法方法：
if ($allowed_method = "0") {
return 405 "Method Not Allowed for this endpoint";
}
proxy_pass http://backend;
}
注意：if 在 location 中是安全的（非 server 根层级），且仅用于简单变量判断，不涉及重写逻辑，符合 Nginx 最佳实践。
实现后端服务按方法分流
不同 HTTP 方法可路由至不同后端集群，例如将读操作（GET/HEAD）发往只读副本，写操作（POST/PUT/DELETE）发往主库节点：
- 定义目标上游变量：
default "read_cluster";
GET "read_cluster";
HEAD "read_cluster";
OPTIONS "read_cluster";
POST "write_cluster";
PUT "write_cluster";
PATCH "write_cluster";
DELETE "write_cluster";
}
- 在 location 中直接使用该变量做代理转发：
proxy_pass http://$upstream_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
此方式天然支持热更新：修改 map 后 reload Nginx 即可生效，无需重启，适合灰度切换或紧急策略调整。
进阶组合：方法 + 路径 + 请求头联合决策
单一方法不足以覆盖复杂场景，可叠加其他变量提升精度。例如：仅对 /admin/ 下的 POST 请求启用写权限，其余 POST 仍走只读：
default "0";
"POST:/admin/users" "1";
"POST:/admin/config" "1";
}
再配合 if ($admin_write_allowed = "0") { return 403; }，即可实现细粒度接口级管控。
