Docker部署Django经Nginx HTTPS代理时静态文件404排查

静态资源返回404、Nginx日志出现未手动配置的/home/backend/web/staticfiles路径，核心原因是jwilder/nginx-proxy的配置加载优先级机制导致你写的全局静态规则被覆盖：

• jwilder/nginx-proxy会为每个配置了VIRTUAL_HOST的后端自动生成独立的server配置块，内置默认静态文件匹配规则，默认静态资源根路径就是/home/backend/web/
• 配置加载优先级为：域名专属vhost配置 > 自动生成的域名默认配置 > 全局default配置，你写在/etc/nginx/vhost.d/default里的/static、/media路由规则优先级低于自动生成的域名配置，根本没有被匹配执行，Nginx实际是按内置默认路径去找静态文件，自然报不存在。
  本地运行正常是因为本地环境未触发自动vhost配置的静态规则注入逻辑。

• 替换全局默认配置为域名专属配置
  不要把静态路由写在default文件中，新建和VIRTUAL_HOST值完全同名的配置文件vhost.d/mydomain.com，把静态路由规则写到这个文件里。同时修改Nginx服务的Dockerfile，将该域名专属配置复制到镜像内对应路径：

  FROM jwilder/nginx-proxy:0.9
  COPY vhost.d/mydomain.com /etc/nginx/vhost.d/mydomain.com
  COPY vhost.d/default /etc/nginx/vhost.d/default
  COPY custom.conf /etc/nginx/conf.d/custom.conf
  

• 强制静态路由匹配优先级
  在静态路径的location规则前加^~修饰符，强制Nginx遇到/static、/media开头的请求时直接命中当前规则，不再执行后续正则匹配或默认规则，避免被自动生成的配置抢占：

  location ^~ /static/ {
    alias /code/staticfiles/;
    add_header Access-Control-Allow-Origin *;
  }
  
  location ^~ /media/ {
    alias /code/mediafiles/;
    add_header Access-Control-Allow-Origin *;
  }
  

• 验证配置生效
  重新构建nginx-proxy镜像并重启容器后，进入nginx-proxy容器执行nginx -T打印全量加载的Nginx配置，搜索location /static/块，确认对应alias路径为/code/staticfiles/，不存在指向/home/backend/web/的静态规则即可。

• 确认静态文件收集操作是在backend容器内部执行，而非宿主机环境，避免静态文件被收集到宿主机路径未写入挂载卷
• 不要在custom.conf中重复定义监听80/443端口的根server块，避免和nginx-proxy自动生成的vhost配置冲突
• 若修改配置后仍返回404，可直接在nginx-proxy容器内执行curl http://127.0.0.1/static/admin/css/base.css发起本地请求，从容器层定位是规则匹配问题还是文件路径问题

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