Django项目上线后静态文件不显示，已执行collectstatic仍无效

• 检查Web服务器的静态文件代理配置
  Debug模式关闭后，Django不会再处理静态文件请求，必须依赖Nginx、Apache这类Web服务器提供静态文件服务：

  • Nginx配置示例：

    location /static/ {
        alias /绝对路径/到你的项目/staticfiles/;
    }
    location /media/ {
        alias /绝对路径/到你的项目/media/;
    }
    

  • Apache配置示例：

    Alias /static/ /绝对路径/到你的项目/staticfiles/
    <Directory /绝对路径/到你的项目/staticfiles/>
        Require all granted
    </Directory>
    
    Alias /media/ /绝对路径/到你的项目/media/
    <Directory /绝对路径/到你的项目/media/>
        Require all granted
    </Directory>
    

  配置完成后记得重启Web服务器生效。

• 验证collectstatic的执行结果
  前往STATIC_ROOT对应的staticfiles目录，确认所有需要的静态文件（包括各app下的static文件、自定义静态目录的文件）都已被复制过来。如果文件缺失：

  • 查看执行python manage.py collectstatic时的控制台输出，检查是否有权限报错或文件忽略提示；
  • 若存在自定义静态文件目录，需在settings.py中补充配置STATICFILES_DIRS，示例：

    STATICFILES_DIRS = [
        os.path.join(BASE_DIR, 'static'),  # 假设项目根目录下有static文件夹
    ]
    

• 修复文件权限问题
  确保staticfiles和media目录的权限允许Web服务器进程读取：

  # Linux下针对Nginx/Apache的www-data用户
  sudo chown -R www-data:www-data /你的项目路径/staticfiles/
  sudo chmod -R 755 /你的项目路径/staticfiles/
  sudo chown -R www-data:www-data /你的项目路径/media/
  sudo chmod -R 755 /你的项目路径/media/
  

• 检查模板中的静态文件引用
  模板里必须使用{% static %}标签加载静态文件，且开头要加载静态标签库：

  {% load static %}
  <link rel="stylesheet" href="{% static 'css/main.css' %}">
  

  避免硬编码/static/xxx路径，确保引用路径和staticfiles目录下的文件结构一致。

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