Nginx API路由需依托匹配优先级、路径精度与指令协作实现精准分发；用^~前缀匹配区分版本与服务，=精确匹配锁定关键入口，~锚定正则处理动态路径，并注意proxy_pass斜杠及头信息透传。
为 API 接口配置专属路由，关键不是“套娃式嵌套”，而是靠匹配优先级、路径精度和指令协作把不同接口请求准确分发到对应后端。Nginx 的 location 块本身不支持嵌套，但通过合理设计路径层级和修饰符，完全可以实现清晰、可维护、高性能的 API 路由体系。
用前缀匹配区分 API 版本与服务边界
API 路径天然具有层级结构（如 /api/v1/users、/api/v2/orders），利用最长前缀匹配就能自然分离：
-
location ^~ /api/v1/：匹配所有 v1 接口，且禁止后续正则检查，性能更稳 -
location ^~ /api/v2/：独立指向新版服务，不会被 v1 规则误捕获 -
location ^~ /api/internal/：专用于内部调用，可加 IP 白名单或 auth_request 鉴权
注意：^~ 比普通 /api/ 优先级更高，也比正则更早触发，适合高频、确定性高的 API 根路径。
用精确匹配锁定关键入口点
登录、健康检查、OpenAPI 文档等固定路径，应使用 = 精确匹配，避免歧义：
-
location = /healthz { return 200 "OK"; }：不走代理，秒级响应 -
location = /login { proxy_pass http://auth-svc; }：只响应/login，不响应/login/或/login?next=...（带查询参数仍匹配）
这类规则优先级最高，匹配即终止搜索，适合高敏感、低延迟的控制类接口。
用锚定正则处理动态资源操作
当路径含变量段（如 ID、动作名），前缀匹配容易过宽，必须用正则限定边界：
-
location ~ ^/api/v2/(users|posts)/\d+/(delete|update)$：只匹配/api/v2/users/123/delete这类标准操作，排除/api/v2/users/123/export等非预期路径 - 配合
limit_except控制方法：limit_except GET POST { deny all; }，防止 PUT/DELETE 被意外放行
正则写在文件靠前位置，并用 ^ 和 $ 锚定首尾，避免误匹配中间子串。
避免常见陷阱：proxy_pass 路径拼接与头信息透传
路由生效后，转发行为同样影响 API 正常工作：
- 末尾斜杠很重要：
proxy_pass http://svc/;（带/）会剥离/api/v2/后再转发；proxy_pass http://svc;（不带）则原样拼接，易导致 404 - 必须透传关键头：
proxy_set_header Host $host;、X-Real-IP、X-Forwarded-For，否则后端无法识别真实客户端或域名 - 跨域调试时可临时加：
add_header 'Access-Control-Allow-Origin' '*';，上线前替换为具体域名
