部署后静态文件未加载，collectstatic成功但Nginx报找不到文件如何解决？

• 步骤1：验证静态卷内的实际文件结构
  首先进入运行中的web容器，确认collectstatic生成的文件路径是否和请求路径匹配：

docker exec -it 你的web服务容器名 bash
ls -l /code/static/pages/

如果该路径下不存在indexAuth.js，说明是collectstatic配置有误，检查Django项目的STATIC_ROOT是否设置为/code/static，STATICFILES_DIRS是否包含了前端打包后静态文件的存放目录。

• 步骤2：验证Nginx容器内的静态文件是否同步
  进入Nginx容器检查对应路径下是否存在目标文件：

docker exec -it 你的nginx服务容器名 bash
ls -l /var/html/static/pages/

如果该路径下没有对应文件，属于卷挂载顺序问题：当前配置中Nginx依赖web服务启动，但web服务启动初期还未执行collectstatic，会先把空的static_value卷挂载给Nginx，后续web容器生成的静态文件不会同步到已挂载的卷。

修复方案：修改docker-compose.yaml中web服务的配置，增加command字段，确保静态文件收集完成后再启动服务：

web:
  image: maskalev/foodgram
  restart: always
  command: bash -c "python manage.py collectstatic --noinput && 替换为你原有的web服务启动命令，例如gunicorn foodgram.wsgi:application -b 0.0.0.0:8000"
  volumes:
    - static_value:/code/static/
    - media_value:/code/media/
  depends_on:
    - db
  env_file:
    - ./.env

• 步骤3：验证Nginx配置并重启服务
  你当前的Nginx静态路径配置符合规则，location /static/配合root /var/html/会自动拼接为/var/html/static/，和挂载路径完全匹配。前两步排查修复完成后，重启Nginx容器即可生效：

docker-compose restart nginx

• 可选兜底方案
  如果上述操作都无效，大概率是旧卷残留了空的静态文件缓存，停止所有服务并删除旧卷后重新启动即可：

docker-compose down -v
docker-compose up -d

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