Heroku部署Django网站遇Error 500：排查数据库/静态文件/URL问题

一、静态文件配置问题 #

• 检查settings.py中STATIC_ROOT是否正确设置，必须指向项目内的一个目录（如os.path.join(BASE_DIR, 'staticfiles')），Heroku依赖该目录收集所有静态文件
• 确认部署前是否执行过python manage.py collectstatic，Heroku部署时会自动执行该命令，但如果本地测试时未运行过，可能存在静态文件缺失、路径错误或权限问题
• 当DEBUG=False时，需确认whitenoise中间件是否配置到位：whitenoise.middleware.WhiteNoiseMiddleware要加入MIDDLEWARE列表，同时STATICFILES_STORAGE需设为whitenoise.storage.CompressedManifestStaticFilesStorage，否则Django无法在生产环境提供静态文件，可能触发500错误

二、URL配置问题 #

• 关闭DEBUG后，需检查根urls.py是否配置了自定义handler500视图，默认的500错误页可能因静态文件加载失败引发嵌套错误，导致返回500
• 排查所有视图函数是否存在未捕获的异常，比如语法错误、未定义变量、调用不存在的方法等，这类问题在DEBUG模式下会显示详细报错，生产环境直接返回500
• 检查URL路由是否存在冲突，比如命名空间重复、正则规则覆盖请求路径，导致请求无法匹配到正确视图，进而触发服务器错误

三、数据库配置问题 #

• 确认DATABASES是否正确读取Heroku的DATABASE_URL环境变量，通常使用dj-database-url库解析，需确保代码中包含import dj_database_url以及DATABASES['default'] = dj_database_url.config(conn_max_age=600)
• 检查是否执行过数据库迁移命令python manage.py migrate，Heroku部署时不会自动执行迁移，若未手动执行或在Procfile中添加迁移步骤，数据库表不存在会直接引发500错误
• 验证Heroku PostgreSQL实例的连接权限，确认应用是否被允许访问数据库，是否存在用户权限不足、数据库实例未创建的情况

四、其他未完成配置问题 #

• 检查SECRET_KEY是否从环境变量读取，生产环境不能硬编码密钥，需用os.environ.get('SECRET_KEY')，若环境变量未设置该值，会直接触发服务器错误
• 确认ALLOWED_HOSTS是否包含Heroku应用的域名（如your-app-name.herokuapp.com），未添加的话Django会拒绝请求并返回500
• 排查第三方服务配置，比如邮件发送、缓存、API调用等，若依赖的服务未配置或凭证错误，视图中调用时会抛出未捕获异常，导致500
• 重点查看Heroku日志的详细报错栈（通过heroku logs --tail命令获取），日志中会明确给出错误原因，比如DoesNotExist模型实例不存在、模块导入错误、权限不足等，这是定位问题最直接的方式

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