Django部署到Heroku服务器后静态文件无法提供服务如何解决？

问题根因 #

你当前的settings.py配置本身没有错误，静态文件加载失效的核心原因是你设置了DISABLE_COLLECTSTATIC=1环境变量。

Django在Debug=False的生产模式下不会自动处理静态资源的搜集聚合，需要执行python manage.py collectstatic命令，把所有分散在各App目录、自定义静态目录下的静态文件统一打包到STATIC_ROOT指向的staticfiles目录，之后whitenoise中间件才能从这个目录读取静态文件对外提供服务。你设置了禁用collectstatic的环境变量后，Heroku部署时自动跳过了这一步，导致staticfiles目录为空，自然无法加载静态资源。

解决步骤 #

• 移除Heroku的DISABLE_COLLECTSTATIC环境变量，执行命令：heroku config:unset DISABLE_COLLECTSTATIC
• 重新推送代码到Heroku触发部署，部署流程会自动执行collectstatic操作，汇总所有静态文件到staticfiles目录
• 部署完成后清空浏览器缓存重新访问站点，静态资源即可正常加载

异常排查 #

如果完成上述操作后仍存在静态文件加载问题，可按如下项逐一排查：

• 确认requirements.txt中已经添加了whitenoise的依赖声明，版本与本地开发环境使用的版本一致
• 检查whitenoise中间件的排序是否正确：必须放在django.middleware.security.SecurityMiddleware之后，其他所有中间件之前
• 可本地临时设置Debug=False，手动执行collectstatic命令后启动服务测试，确认静态文件可正常访问后再推送到Heroku部署

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