Django static文件无法加载且报错信息不明确 问题求助

你遇到的静态文件加载失败问题核心是配置项拼写错误，完整排查修复方案如下：

• 修正settings.py中的配置项，Django指定的静态文件目录配置项为STATICFILES_DIRS，你当前写的STATICFILES_DIR缺少末尾的字母S，属于无效配置，修改后内容如下：

STATIC_URL = '/static/'
STATICFILES_DIRS = [str(BASE_DIR.joinpath('static'))]

• 确认项目根目录下的static文件夹存在，且style.css文件直接存放在该目录下，注意Linux/macOS环境下文件夹名称大小写敏感，需和配置中的名称完全一致。
• 开发环境下（DEBUG = True），检查项目主urls.py文件是否添加了静态文件路由映射，添加方式如下：
  1. 顶部导入依赖：

  from django.conf import settings
  from django.conf.urls.static import static
  

  2. 在urlpatterns列表末尾追加路由规则：

  urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
  

• 完成上述修改后重启Django服务，清除浏览器缓存后重新加载页面即可正常加载CSS文件。

如果是生产环境部署，需额外配置STATIC_ROOT参数，执行python manage.py collectstatic命令收集所有静态文件到指定目录后，交由Nginx等Web服务器处理静态资源请求即可。

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