Django部署Heroku：DEBUG=False时500错误排查与配置方案

遇到这种DEBUG切到生产模式就出500的情况太常见了，我帮你梳理几个最可能的原因和对应的解决办法，一步步排查应该就能搞定：

1. 先搞定静态文件的问题 #

当DEBUG=True时，Django会自动帮你托管静态文件，但生产环境下DEBUG=False后，这个“福利”就没了，必须自己配置静态文件的收集和托管：

• 先检查settings.py里的静态文件配置是否齐全：

  STATIC_URL = '/static/'
  # collectstatic命令收集静态文件的目标目录
  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  # 项目里存放自定义静态文件的目录（比如app下的static文件夹）
  STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
  # 启用Whitenoise托管静态文件（Heroku上的常用方案）
  STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
  

• 然后确认中间件里加了Whitenoise，位置要在SecurityMiddleware之后：

  MIDDLEWARE = [
      'django.middleware.security.SecurityMiddleware',
      # 必须放在SecurityMiddleware后面
      'whitenoise.middleware.WhiteNoiseMiddleware',
      # 其他中间件...
  ]
  

• 另外，Heroku通常会自动运行python manage.py collectstatic，如果没触发，你可以手动在本地执行后再部署，或者登录Heroku终端直接运行该命令。

2. 修正ALLOWED_HOSTS的配置 #

你现在写的['.myDomain.de']有两个小问题：

• 域名大小写不匹配：浏览器发送的Host头都是小写的，Django的ALLOWED_HOSTS匹配区分大小写，所以改成全小写的.mydomain.de
• 漏掉了Heroku默认域名：Heroku内部请求会用<你的应用名>.herokuapp.com这个域名，不加上的话也会触发错误

建议改成这样：

ALLOWED_HOSTS = ['www.mydomain.de', 'mydomain.de', '<你的应用名>.herokuapp.com']

或者用更灵活的环境变量配置，避免硬编码：

import os
ALLOWED_HOSTS = os.environ.get("ALLOWED_HOSTS", "www.mydomain.de,mydomain.de,<你的应用名>.herokuapp.com").split(",")

然后在Heroku终端设置环境变量：

heroku config:set ALLOWED_HOSTS="www.mydomain.de,mydomain.de,<你的应用名>.herokuapp.com"

3. 检查SECRET_KEY是否正确配置 #

生产环境下DEBUG=False时，Django不允许使用默认的SECRET_KEY，必须设置一个有效的密钥，而且绝对不能硬编码在代码里：

• 在settings.py里改成：

  SECRET_KEY = os.environ.get('SECRET_KEY', '临时测试密钥（生产环境必须替换）')
  

• 用Django自带命令生成安全密钥，再设置到Heroku：

  # 本地终端生成密钥
  python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
  # 将生成的密钥设置到Heroku
  heroku config:set SECRET_KEY="刚才生成的密钥内容"
  

4. 查看Heroku日志定位具体错误 #

500是通用服务器错误，上面的步骤都是常见问题，但如果还是没解决，一定要看日志找具体原因：
打开本地终端，运行：

heroku logs --tail

这个命令会实时输出应用日志，你刷新出错页面后，就能看到具体的错误堆栈——比如数据库连接失败、依赖包缺失、模板语法错误（DEBUG=True时会忽略部分严格检查）等等，根据日志信息针对性修复即可。

最后确认django_heroku的配置 #

你已经导入了django_heroku，记得在settings.py的最后一行加上：

django_heroku.settings(locals())

它会帮你自动配置Heroku的数据库、静态文件、日志等环境，省掉很多手动配置的麻烦。

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