Nginx反向代理location路由异常：Docker环境下/v1路径无法转发

核心错误：Location匹配规则使用错误 #

你之前用的location = /v1/*是完全错误的写法——精确匹配模式（=）不支持通配符，这个规则不会匹配任何请求，导致所有请求都落到了兜底的location /里，返回前端HTML。

正确的配置写法 #

直接替换成前缀匹配即可，推荐两种写法：

写法1：普通前缀匹配（优先推荐）

location /v1/ {
    proxy_pass http://diagnosy-backend;
    # 可选但建议添加的代理头，保证后端能正确获取客户端信息
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

这个规则会匹配所有以/v1/开头的请求（比如/v1/status、/v1/user/list等），优先级比location /更高（因为前缀更长）。

写法2：强制前缀匹配（避免正则干扰）

如果你的配置里还有正则匹配规则，担心被正则抢占，可以用^~强制让前缀匹配优先：

location ^~ /v1/ {
    proxy_pass http://diagnosy-backend;
    # 同上代理头配置
}

额外注意：Proxy_pass的路径处理 #

如果你的后端服务是直接监听/status而不是/v1/status，需要在proxy_pass末尾加/，这样Nginx会把/v1/后面的路径拼接在后端地址后：

location /v1/ {
    proxy_pass http://diagnosy-backend/; # 末尾加/
}

比如请求/v1/status会被转发到http://diagnosy-backend/status。

关于Location规则的学习资源 #

1. Nginx官方核心模块文档：里面明确了四种匹配模式的优先级（从高到低）：
   • 精确匹配=
   • 强制前缀匹配^~
   • 正则匹配~（大小写敏感）/~*（大小写不敏感）
   • 普通前缀匹配（最长前缀优先）
2. 国内技术社区的实战文章：比如掘金、InfoQ上的Nginx反向代理系列，很多会用实际案例讲解匹配规则的坑，比如精确匹配的严格性、前缀匹配结尾/的影响等。

内容的提问来源于stack exchange，提问作者Pambalos