Django CSS静态文件加载失败，已执行collectstatic如何排查错误？

已确认的核心错误 #

• 重复声明STATICFILES_DIRS配置项：Python变量后声明的值会覆盖前者，你第一次定义的包含/var/www/static/路径的配置会被第二次的元组配置完全覆盖，如果你有静态文件存放在第一次声明的路径下会直接无法找到。同时配置中混用了pathlib路径写法（BASE_DIR / "static"）和os.path写法，定义的STATIC_DIR变量没有被实际使用，属于冗余配置。

其他可能的问题排查方向 #

• 静态文件目录结构不匹配：你模板中引用的路径为{% static 'HomePage/style.css' %}，需要确认对应的静态文件存放路径符合以下两种规则之一：
  • 全局静态文件目录：项目根目录/static/HomePage/style.css
  • 应用内静态文件目录：HomePage应用目录下路径为HomePage/static/HomePage/style.css，且HomePage已经加入settings.py的INSTALLED_APPS列表中
• 开发环境错误执行collectstatic命令：python manage.py collectstatic是生产环境部署时用于收集所有静态文件到STATIC_ROOT目录的命令，开发环境DEBUG=True时不需要执行该命令，收集后的静态文件可能和开发模式下的静态文件路由冲突。
• 路由配置缺失：如果你的DEBUG配置为False，需要在项目根urls.py中手动添加静态文件路由规则，否则Django不会处理静态资源请求。

修复步骤 #

1. 清理settings.py中的冗余静态配置，示例如下（可根据你的实际需求调整路径）：

STATIC_URL = '/static/'
# 全局静态文件查找目录，不需要的路径可以删除
STATICFILES_DIRS = [
    BASE_DIR / "static",
    # '/var/www/static/',  没有用到该路径就注释或删除
]
STATIC_ROOT = BASE_DIR.parent / "static_in_env" / "static_root"
# 没用的STATIC_DIR配置可以直接删除

2. 按照上文中的目录规则检查你的style.css存放路径，确保和模板引用的路径一致。
3. 开发环境下删除collectstatic生成的static_in_env目录内容，重启python manage.py runserver测试。
4. 如果是生产环境部署，确认你的Web服务器（Nginx/Apache）的静态资源路由已经正确指向STATIC_ROOT对应的目录。
5. 可以打开浏览器控制台查看CSS文件的请求状态，如果返回404可以直接访问报错的CSS资源地址，确认路径是否符合预期。

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