Docker环境下Django collectstatic未将静态文件复制到STATIC_ROOT问题

以下是针对该问题的排查和解决步骤：

• 调整容器启动命令的执行顺序
  Docker卷挂载会覆盖容器内对应目录的原有内容。确保collectstatic命令在卷挂载后执行，推荐在docker-compose.yml的服务command中明确执行顺序：

  services:
    api:
      command: sh -c "python manage.py collectstatic --noinput && gunicorn your_project.wsgi:application --bind 0.0.0.0:8000"
      volumes:
        - static_volume:/usr/src/app/staticfiles
  

  这样collectstatic会直接将文件写入挂载的卷中，而非被卷覆盖的容器内目录。

• 验证STATIC_ROOT的绝对路径匹配性
  在Django容器内执行python manage.py shell，打印实际路径确认：

  import os
  from django.conf import settings
  print(settings.BASE_DIR)
  print(settings.STATIC_ROOT)
  

  确保输出的STATIC_ROOT绝对路径和docker-compose.yml中挂载的/usr/src/app/staticfiles完全一致。如果项目代码放在子目录中，BASE_DIR可能指向子目录，导致STATIC_ROOT路径错位。

• 检查目录写入权限
  确认执行collectstatic的用户对STATIC_ROOT目录有写入权限。在Dockerfile中添加权限配置：

  RUN mkdir -p /usr/src/app/staticfiles
  RUN chown -R your_app_user:your_app_user /usr/src/app/staticfiles
  

  如果用root用户执行命令，收集完成后可调整权限避免Nginx访问问题：

  python manage.py collectstatic --noinput && chown -R nginx:nginx /usr/src/app/staticfiles
  

• 直接检查命名卷的内容
  用命令查看卷的宿主机存储路径：

  docker volume inspect static_volume
  

  找到Mountpoint字段对应的本地路径，直接查看该目录下是否有静态文件。如果文件存在，说明问题出在Nginx配置：检查Nginx的卷挂载路径是否正确，以及Nginx配置中location /static/的root是否指向卷挂载目录。

• 理清STATIC_ROOT与STATICFILES_DIRS的作用
  STATIC_ROOT是collectstatic的唯一目标目录，STATICFILES_DIRS用于指定额外的静态文件来源目录（比如项目自定义的static目录）。不要将STATIC_ROOT加入STATICFILES_DIRS，也不要用STATICFILES_DIRS替代STATIC_ROOT的配置。

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