Docker容器中Django无法通过Nginx加载静态文件求助

核心问题定位 #

从你描述的现象来看，静态文件能通过Nginx直接访问，但页面加载异常，核心原因是静态文件收集路径与Nginx挂载卷的匹配问题，加上Debug模式下Django自带静态服务和Nginx的路由冲突导致的。

具体修复步骤 #

1. 确保静态文件正确同步到共享卷 #

Django关闭Debug后不会自动托管静态文件，必须执行collectstatic命令把所有静态资源集中到STATIC_ROOT目录，且这个目录要和Nginx挂载的卷打通：

• 先修改Django容器（gunicorn服务）的Docker Compose配置，把STATIC_ROOT目录挂载到nginx_static卷：

  gunicorn:
    # 保留原有配置...
    volumes:
      - nginx_static:/path/to/your/django/project/../static
  

  注意替换/path/to/your/django/project为你Django容器内的实际项目根路径，确保和settings.py里STATIC_ROOT的路径一致。
• 进入Django容器执行静态文件收集命令：

  docker exec -it [你的gunicorn容器名] python manage.py collectstatic --noinput
  

  这一步会把所有app的静态文件、STATICFILES_DIRS里的资源全部复制到STATIC_ROOT对应的共享卷中，让Nginx能读取到。

2. 修正Nginx静态资源路由配置 #

你当前的alias配置容易出现路径拼接错误，建议换成更直观的root配置，同时补充必要的代理头：

http {
    sendfile on;

    server {
        listen 80;
        server_name localhost;

        location / {
            proxy_pass http://gunicorn:8000;
            # 补充代理头，避免Django获取不到正确请求信息
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
        location /static/ {
            root /;
            expires 30d; # 开启静态资源缓存，优化加载速度
            autoindex off; # 关闭目录索引，提升安全性
        }
    }
}

解释：用root /的话，Nginx会把/static/xxx直接映射到容器内的/static/xxx，和你挂载的nginx_static:/static完全匹配，比alias更不容易出错。

3. 验证Django静态配置的路径正确性 #

在settings.py里打印路径确认STATIC_ROOT是否正确：

import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# 打印路径用于验证
print(f"BASE_DIR: {BASE_DIR}")
print(f"STATIC_ROOT: {os.path.abspath(os.path.join(BASE_DIR, '../static'))}")

确保这个STATIC_ROOT在Django容器内是存在的，且已经挂载到共享卷。

4. 排查模板与静态文件的引用问题 #

部分CSS无法加载，大概率是这两个原因：

• CSS文件内的相对路径问题：比如CSS里写../img/bg.jpg，通过Nginx访问时路径层级不对。解决方法是把CSS里的资源引用改成绝对路径，或者用Django模板语言生成CSS（比如把CSS改成模板文件，用{% static %}生成资源链接）。
• 静态文件权限问题：进入Nginx容器检查文件权限：

  docker exec -it [你的nginx容器名] ls -l /static
  

  如果权限不足，可在Django容器执行collectstatic后，执行chmod -R 755 /path/to/static修改权限。

5. 关闭Debug模式的注意事项 #

关闭DEBUG = False后，必须确保：

• ALLOWED_HOSTS包含Nginx访问的域名（比如ALLOWED_HOSTS = ['localhost']）
• 已经完成collectstatic操作，所有静态资源都在共享卷中
• 完全依赖Nginx托管静态资源，不再依赖Django自带的静态服务

验证步骤 #

1. 重启所有容器：docker-compose down && docker-compose up -d
2. 访问localhost:80，检查页面静态资源加载情况
3. 查看Nginx日志排查错误：docker logs [你的nginx容器名]
4. 查看Django日志排查请求问题：docker logs [你的gunicorn容器名]

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