Docker部署Django项目中Nginx无法加载静态文件，路径配置有误？

我尝试在Django项目中用Docker部署Nginx，已确认Docker卷存在且能正常访问Swagger路径，但静态文件加载失败，求其他解决思路。相关配置如下：

settings.py 静态文件配置 #

# Static files
STATIC_URL = "/static/"
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
]
STATIC_ROOT = os.path.join(BASE_DIR, "staticfiles")

nginx/nginx.conf 配置 #

events {
    worker_connections  1024;
}

http {
    upstream django {
        server web:8000;
    }

    server {
        server_name localhost;
        access_log off;
        listen 80;

        location /static/ {
            alias /app/staticfiles/;
        }

        location / {
            proxy_pass http://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;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

docker-compose.yml 配置 #

version: '3.8'

services:
  web:
    build: .
    command: gunicorn core.wsgi:application --bind 0.0.0.0:8000 --timeout 120 --workers 3
    volumes:
      - .:/app
      - static_volume:/app/staticfiles
    ports:
      - "8000:8000"
    depends_on:
      - redis
  nginx:
    image: nginx:latest
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
      - static_volume:/app/staticfiles
    ports:
      - "80:80"
    depends_on:
      - web
......
volumes:
  static_volume:

可尝试的解决方法 #

• 确认collectstatic已执行：STATIC_ROOT目录需要手动收集静态文件，要么在Dockerfile中添加RUN python manage.py collectstatic --noinput（构建镜像时执行），要么进入web容器手动执行python manage.py collectstatic --noinput，确保/app/staticfiles目录下有静态文件。
• 检查Nginx容器内静态文件是否存在：进入Nginx容器执行ls /app/staticfiles，确认目录下有文件；如果为空，说明卷同步有问题，检查web容器是否正确将文件写入了static_volume卷。
• 修复文件权限问题：Nginx可能没有读取静态文件的权限，进入web容器执行chmod -R 755 /app/staticfiles，或者在Dockerfile中设置运行用户（比如创建非root用户），避免权限冲突。
• 绕开Nginx测试静态文件：直接访问web容器的8000端口（如http://localhost:8000/static/css/style.css），如果能正常加载，说明问题出在Nginx配置；如果不能，说明静态文件收集未完成或路径配置错误。
• 启用Nginx日志排查：修改nginx.conf，将access_log off;改为access_log /var/log/nginx/access.log;，同时添加error_log /var/log/nginx/error.log;，然后进入Nginx容器查看日志，定位404、权限错误等具体问题。
• 验证模板中静态文件引用方式：确保模板中使用Django的{% load static %}和{% static 'path/to/file' %}标签引用静态文件，而非硬编码路径，避免路径不匹配。
• 检查卷挂载路径一致性：确认web容器和Nginx容器挂载static_volume的路径都是/app/staticfiles，你的配置中已经一致，但可以用docker volume inspect static_volume查看卷的实际存储路径，确认宿主机端有文件。

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