Django生产环境静态文件加载失败问题排查求助

1. 确认执行collectstatic命令 #

当DEBUG=False时，Django不会自动托管静态文件，必须手动将所有静态资源收集到STATIC_ROOT指定的目录：

python manage.py collectstatic

执行时确认覆盖目录内容，完成后检查项目根目录下的static文件夹（即STATIC_ROOT），确认目标资源（如index/images/capabilities-2.jpg）是否存在于该目录中。

2. 检查静态文件目录权限 #

确保STATIC_ROOT目录及其内容的权限允许Web服务器（如Nginx、Apache）读取：

# 以Nginx为例，将目录权限赋予www-data用户组
chown -R www-data:www-data /path/to/your/project/static
# 或设置通用可读权限
chmod -R 755 /path/to/your/project/static

3. 配置Web服务器托管静态资源 #

Django生产环境不负责静态文件分发，需通过Web服务器处理/static/路径的请求。以Nginx为例，在站点配置中添加以下规则：

location /static/ {
    alias /path/to/your/project/static/;  # 注意末尾斜杠，保证路径映射正确
    expires 30d;  # 可选，设置静态资源缓存时间
}

配置完成后重启Nginx生效：

sudo systemctl restart nginx

4. 修正静态文件引用路径 #

从日志可见，部分资源（如/css/index_styles.css）未使用{% static %}模板标签，导致路径错误。需将所有静态资源引用统一改为模板标签形式：

<!-- 错误写法 -->
<link rel="stylesheet" href="/css/index_styles.css">
<!-- 正确写法 -->
<link rel="stylesheet" href="{% static 'css/index_styles.css' %}">

<!-- 图片引用需匹配收集后的目录结构 -->
<img src="{% static 'index/images/capabilities-2.jpg' %}" class="img-fluid">

若项目存在自定义静态文件（非app目录下的static文件夹），需在settings.py中配置STATICFILES_DIRS，告知Django收集时包含这些目录：

STATICFILES_DIRS = [
    BASE_DIR / "static_src",  # 替换为你的自定义静态文件目录
]

注意：STATIC_ROOT是collectstatic的目标目录，不要手动向其中添加文件，所有静态资源应放在STATICFILES_DIRS指定目录或app的static目录中，再通过collectstatic收集。

5. 处理favicon.ico等特殊资源 #

对于favicon.ico这类资源，可将其放入静态目录，使用{% static 'assets/favicon.ico' %}引用，或在Web服务器中单独配置路径：

location /favicon.ico {
    alias /path/to/your/project/static/assets/favicon.ico;
}

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