Django部署Heroku时Debug=False返回500错误 静态文件缺失manifest条目

问题根因 #

你遇到的500错误和session无关，是静态资源引用错误导致的：DEBUG=True时Django会自动查找静态文件，不会走存储策略的强校验，所以一切正常；DEBUG=False时会启用你配置的whitenoise.storage.CompressedManifestStaticFilesStorage静态存储策略，这个策略会要求所有引用的静态文件都能在collectstatic生成的资源清单里匹配到，匹配失败就直接抛出500错误。你说的需要读取session的页面刚好引用了路径错误的bootstrap.css文件，才让你误以为是session相关的问题。

解决方案 #

• 首先修正模板中的静态资源引用方式：所有静态文件不要硬写/css/bootstrap.min.css这类绝对路径，必须使用Django自带的static模板标签。先在模板顶部声明{% load static %}，再把css引用语句改成{% static 'css/bootstrap.min.css' %}，注意路径开头不要加斜杠。
• 检查静态文件存放路径：确认bootstrap.min.css文件实际存放在对应app的static/css/目录下，如果你用了全局静态目录，要在settings.py中补充配置STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")]，把全局静态目录路径加进去。
• 本地先执行静态资源收集验证：本地运行python manage.py collectstatic，执行完成后检查生成的staticfiles目录下是否存在css/bootstrap.min.css，以及同目录下的staticfiles.json清单中是否有对应的资源条目。
• 可选临时兜底配置：如果需要紧急恢复服务，可以在settings.py中加一行配置WHITENOISE_MANIFEST_STRICT = False，这个配置会让whitenoise找不到资源清单条目时回退到直接请求原路径，不会直接抛500，不过还是建议优先修正引用路径从根源解决问题。
• 部署后验证：推送到Heroku后平台会自动执行collectstatic，如果没有自动执行可以手动执行heroku run python manage.py collectstatic，完成后再访问页面验证。

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