使用Whitenoise时Django DRF可浏览API CSS无法加载问题排查

1. 确认DRF静态文件已被正确收集 #

• 执行命令：

  python manage.py collectstatic
  

• 检查项目根目录下的static文件夹，确认是否存在rest_framework子目录，里面包含css、js等静态资源。
• 如果没有该目录，检查settings.py的INSTALLED_APPS是否添加了'rest_framework'——DRF的静态文件属于其内置app资源，必须在INSTALLED_APPS中声明才能被collectstatic收集。

2. 校验STATIC配置的一致性 #

• 检查浏览器控制台的网络请求：访问DRF页面时，查看CSS/JS请求的路径（例如/assets/rest_framework/css/bootstrap.min.css），确认返回状态码。若为404，说明路径映射存在问题。
• 验证BASE_DIR路径正确性：在终端执行：

  python manage.py shell
  

  输入以下代码确认BASE_DIR指向项目根目录：

  from django.conf import settings
  print(settings.BASE_DIR)
  

• 你定义的STATIC_LOCATION属于自定义变量，Django默认不识别，可删除或在需要的地方显式引用，避免混淆配置。

3. 区分开发/生产环境排查 #

开发环境（DEBUG=True）

• Django默认会自行处理静态文件，此时可暂时注释Whitenoise相关配置（中间件、STORAGES），仅保留django.contrib.staticfiles在INSTALLED_APPS中。
• 若此时静态资源仍无法加载，说明问题出在Django基础配置，而非Whitenoise。

生产环境（DEBUG=False）

• 必须确保已执行collectstatic，且STATIC_ROOT目录存在并包含完整静态资源。
• 检查ALLOWED_HOSTS是否包含当前访问的域名/IP，否则Django会返回400错误导致页面空白。
• 查看服务器日志，定位具体缺失的静态资源路径，确认路径映射是否匹配STATIC_URL配置。

4. 验证自定义静态文件加载 #

• 执行collectstatic后，检查static目录是否包含assets下的自定义CSS/JS文件。
• 直接访问自定义资源路径（例如/assets/custom.css），若无法加载，说明静态文件的基础映射逻辑存在问题，需重新核对STATICFILES_DIRS、STATIC_ROOT、STATIC_URL的配置关系。

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