Django生产环境静态文件失效求助（已执行collectstatic）

1. 检查Django settings.py核心配置 #

确保以下参数配置准确：

• STATIC_URL = '/static/'：该配置决定前端页面发起的静态文件请求路径，必须与Nginx的location规则匹配
• STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')：保证collectstatic生成的文件目录与你挂载到容器的路径完全一致
• DEBUG = False：生产环境必须关闭DEBUG模式，否则Django会自行处理静态文件请求，违背Nginx代理的配置逻辑

2. 验证collectstatic执行有效性 #

• 在Django容器内执行python manage.py collectstatic --noinput，确认staticfiles目录下存在admin、css等子文件夹及对应静态文件
• 修复目录权限：在Dockerfile中添加RUN chmod -R 755 /app/staticfiles，确保Nginx容器对该目录有读取权限

3. 修正Nginx ssl.conf配置 #

确保location /static/规则配置正确，示例如下：

location /static/ {
    alias /app/staticfiles/;  # 注意末尾斜杠，必须与STATIC_ROOT路径严格对应
    expires 30d;
    add_header Cache-Control "public, max-age=2592000";
}

• 优先使用alias而非root：root会将location路径拼接到目标目录后，而alias会直接替换请求路径，更适配静态文件代理场景
• 进入Nginx容器执行ls /app/staticfiles/admin/css/，确认静态文件实际存在

4. 修正docker-compose卷挂载配置 #

确保卷挂载逻辑正确，示例配置：

services:
  django:
    volumes:
      - static_volume:/app/staticfiles
  nginx:
    volumes:
      - static_volume:/app/staticfiles
volumes:
  static_volume:

• 避免在Dockerfile中复制staticfiles目录：卷挂载会覆盖容器内原有目录，建议在容器启动时执行collectstatic（可通过Dockerfile的CMD或entrypoint配置）

5. 排查请求路径异常 #

• 若出现/staticfiles/...的请求，说明页面生成的静态文件路径错误，检查STATIC_URL是否为/static/而非/staticfiles/
• 强制刷新浏览器（Ctrl+F5）清除缓存，避免旧请求路径干扰

6. 验证Nginx配置合法性 #

在Nginx容器内执行nginx -t检查配置语法，确认无误后重启Nginx：service nginx restart

内容的提问来源于stack exchange，提问作者L.S