Nginx中location /api应写为/location /api/以正确匹配子目录。因前缀匹配不校验路径边界，/api会错误匹配/apixxx等路径；代理时需proxy_pass末尾加斜杠以剥离前缀。
在 Nginx 中，location 前缀匹配（如 location /api）若未加尾部斜杠，会导致子目录路径（如 /api/v1/user）被错误匹配或穿透到后端，尤其在代理场景下容易出现 404 或路由错乱。根本原因在于：Nginx 的前缀匹配是“最长字符串匹配”，不校验路径边界，/api 会匹配 /api、/api/、/api/v1、甚至 /apixxx —— 后者虽少见，但说明它不按目录语义切分。
确认是否为尾部斜杠缺失问题
用 curl -I 或浏览器开发者工具检查请求实际到达的 location 块：
- 访问
/api/v1/users，查看响应头中X-Location-Matched（可自定义添加）或通过error_log+log_subrequest on观察匹配日志 - 在对应
location块中临时加return 200 "matched: /api";，验证是否真命中 - 对比
/api/（带斜杠）和/api（不带）的响应差异，若前者正常后者 404 或透传，大概率是匹配粒度问题
正确写法：按语义区分目录与精确路径
根据用途选择匹配方式，避免模糊前缀：
-
匹配整个子目录（推荐）：写成
location /api/ { ... }—— 尾部斜杠表示“以该路径为根的目录”，Nginx 会自动处理内部重写和代理路径，且不会匹配/apixxx -
精确匹配单个路径：用
location = /api { ... }，仅匹配字面量/api，不匹配任何子路径 -
避免裸前缀：删除
location /api { ... }这类无斜杠、无等号的写法，除非你明确需要匹配所有以/api开头的路径（含/apixxx）
调试技巧：快速验证匹配逻辑
利用 Nginx 内置变量和日志定位实际匹配行为：
- 在
http或server块启用详细匹配日志：error_log /var/log/nginx/debug.log notice;，并编译时加--with-debug（或使用预编译 debug 包） - 在 location 中添加：
add_header X-Real-URI $request_uri;和add_header X-Location $location;，响应头中直接看到匹配结果 - 用
nginx -t && nginx -s reload后，立即用curl -I http://localhost/api/v1/test查看响应头变化
代理场景下的路径修正（关键！）
即使 location 写对了 /api/，若后端服务期望路径为 /v1/user（即去前缀），必须显式重写：
- 错误写法：
proxy_pass http://backend;—— 会把完整/api/v1/user透传过去 - 正确写法：
proxy_pass http://backend/;（注意 proxy_pass 值末尾有斜杠）—— Nginx 会自动剥离/api/，只转发/v1/user - 或用 rewrite：
rewrite ^/api/(.*)$ /$1 break;+proxy_pass http://backend;，但优先推荐 proxy_pass 尾斜杠方式
