Docker环境Nginx配置proxy_pass报no resolver解析错误

一、现有location规则问题排查 #

你编写的规则不符合需求，存在语法错误与逻辑漏洞，具体问题如下：

• 语法错误：第二个location块缺失左大括号{，会导致Nginx配置加载失败，正确的块结构需要用大括号包裹块内所有指令。
• 正则匹配漏洞：正则未加起始锚点^，会误匹配/other-prefix/api/cars/123这类带额外前缀的路径，超出预期匹配范围。
• 参数透传缺失：proxy_pass中使用了正则捕获变量$1时，Nginx不会自动拼接原请求的查询字符串，会导致?后的参数丢失。
• 匹配顺序逻辑正确：将更长的/model路径规则写在前面，符合Nginx正则location按书写顺序优先匹配的规则，不会出现短路径抢先匹配的问题。

修正后的可正常匹配需求的配置如下：

# 长路径规则优先书写，加^锚定路径起始位置，$锚定路径结尾，阻断下级路径匹配
location ~* ^/api/cars/([A-Za-z0-9]+)/model$ {
    # 追加$is_args$args透传原请求的query参数
    proxy_pass https://myapi/api/cars/$1/model$is_args$args;
}
location ~* ^/api/cars/([A-Za-z0-9]+)$ {
    proxy_pass https://myapi/api/cars/$1$is_args$args;
}

以上配置可以实现：

• 仅匹配/api/cars/{carID}和/api/cars/{carID}/model两个精确路径，自动透传查询参数
• 所有带下级路径的请求（比如/api/cars/123/other、/api/cars/123/model/xxx）都不会命中规则，不会被代理

二、no resolver defined to resolve myapi报错解决 #

报错原因 #

Nginx的域名解析逻辑分两种场景：

1. 当proxy_pass后是纯静态字符串、无任何变量时，Nginx会在启动加载配置时一次性解析域名，此时默认读取系统resolv.conf配置
2. 当proxy_pass中包含变量（比如你配置里的正则捕获值$1、参数变量$args）时，Nginx会在每次请求到来时动态解析域名，此时必须显式配置resolver指令指定DNS服务器，不会自动读取系统resolv.conf，因此会抛出该报错。

针对Docker运行场景的解决步骤 #

• 先进入Nginx容器执行nslookup myapi，确认容器网络环境下可以正常解析该域名，排除宿主机DNS转发、容器网络连通性问题。
• 在Nginx配置的http层级添加resolver配置，推荐优先使用Docker内置DNS地址127.0.0.11（该地址为Docker daemon内置DNS服务，会自动继承宿主机DNS配置，适配绝大多数Docker网络场景），配置示例：

http {
    # 保留你原有其他配置
    # resolver指定DNS服务器，valid设置解析结果缓存时间，ipv6=off关闭ipv6解析避免超时
    resolver 127.0.0.11 valid=30s ipv6=off;
    resolver_timeout 5s;

    server {
        listen 80;
        # 此处放置上面修正后的location规则
    }
}

• 如果内置DNS解析失败，可以替换resolver地址为Windows宿主机的内网IP、或者可用的公共DNS（比如114.114.114.114），确保容器到该DNS地址的UDP 53端口连通正常。

替代方案（无需配置resolver） #

如果不想使用动态解析，可以将代理目标定义为静态upstream，此时Nginx会在启动时解析域名，不需要显式配置resolver，示例：

# 定义静态upstream，无变量时启动时解析域名
upstream myapi_backend {
    server myapi:443;
}

# location中引用upstream
location ~* ^/api/cars/([A-Za-z0-9]+)/model$ {
    proxy_pass https://myapi_backend/api/cars/$1/model$is_args$args;
}
location ~* ^/api/cars/([A-Za-z0-9]+)$ {
    proxy_pass https://myapi_backend/api/cars/$1$is_args$args;
}

注意：该方案下如果myapi对应的IP发生变化，Nginx不会自动更新解析结果，需要重载配置才会生效，适合域名对应IP固定的场景。

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