Docker容器中Nginx proxy_pass无法正常处理后端代理的静态文件

核心冲突来自Nginx的location匹配优先级规则设计，和当前配置逻辑不匹配：

• Nginx的location匹配执行顺序是固定的：带=的精确匹配 > 带^~标记的最长前缀匹配 > 按书写顺序匹配正则规则（~区分大小写、~*不区分大小写） > 无任何修饰符的普通前缀匹配（作为最后兜底）
• 你配置的location /backend/是无修饰符的普通前缀匹配，优先级低于正则匹配规则。当请求路径为/backend/uploads/events/1.jpg时，匹配流程如下：

1. 普通前缀匹配阶段，最长命中/backend/路径规则
2. 因为这个规则没有加^~标记，Nginx不会停止匹配流程，会继续向下执行正则匹配
3. 请求直接命中你配置的全局静态资源后缀正则规则（匹配所有jpg/png/css/js等类型文件）
4. 请求被正则规则接管，不再执行/backend/块里的proxy_pass转发逻辑；而这个正则块里没有配置上游代理，Nginx会直接在本地静态资源目录查找对应文件，找不到就返回404，和你实际遇到的现象完全一致。

给后端代理路径加强制匹配标记 #

修改/backend/对应的location块，加上^~修饰符，让匹配到该路径的请求直接走代理逻辑，跳过后续的正则匹配流程：

location ^~ /backend/ {
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://backend-admin:2082/;
}

改动后，只要请求路径以/backend/开头，不管后面带什么静态资源后缀，Nginx都会直接把请求转发给后端服务，不会再被全局静态资源规则拦截。

调整全局静态资源规则的匹配范围 #

原来的静态资源缓存规则是全局匹配所有静态文件，很容易和代理路径产生冲突，可以加上负向前瞻，排除后端代理的路径，同时补上缺失的代理转发逻辑：

location ~* ^/(?!backend/).+\.(jpg|jpeg|gif|png|ico|css|pdf|ppt|txt|bmp|rtf|ttf|svg|js)$ {
    expires 2d;
    add_header Cache-Control public;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://frontend-admin:8080;
}

原配置里的静态资源location块没有配置proxy_pass，就算是前端服务的静态资源请求，也会被Nginx当成本地文件查找，实际访问时大概率也会返回404，补上代理逻辑才符合预期。

配置校验与重载 #

修改完配置后，先在Nginx容器内完成语法校验，确认无错误再平滑重载：

• 执行 nginx -t 检查配置语法
• 语法校验通过后，执行 nginx -s reload 重载配置，不需要重启容器

• 重载配置后，用curl -I命令测试目标请求，查看响应头定位转发状态：
  执行 curl -I http://example.com/backend/uploads/events/1.jpg
  正常转发的情况下，响应头会显示后端Node.js服务返回的标识，不会出现Nginx本地返回的404状态码。
• 遇到匹配逻辑不明确的问题，可以临时打开Nginx的debug日志，在日志输出中直接查看每个请求实际命中的location块，快速定位拦截请求的规则。

内容的提问来源于stack exchange，提问作者אלנ נורמן