如何让Django正确连接Heroku Postgres并解决迁移报错？

核心问题说明 #

你删除硬编码环境变量的做法是完全正确的——Heroku会自动为你添加的Postgres实例维护DATABASE_URL环境变量，不需要手动设置。报错的原因是配置逻辑没正确读取Heroku自动生成的这个变量，或者依赖缺失导致无法解析数据库连接。

分步解决方案 #

1. 确认Heroku自动配置的DATABASE_URL存在

先在终端执行命令，验证Heroku是否已经为你的应用设置了正确的数据库URL：

heroku config:get DATABASE_URL -a myapp

如果返回类似postgres://xxx:xxx@xxx.amazonaws.com:5432/xxx的字符串，说明Heroku已经自动配置好了，无需手动添加任何环境变量。

2. 修正settings.py的数据库配置逻辑

要区分本地开发和Heroku生产环境的配置，同时确保正确读取动态的DATABASE_URL：

• 首先安装依赖：本地开发需要python-dotenv加载.env，生产环境需要dj-database-url解析数据库URL。把这两个包加入requirements.txt（python-dotenv也可以单独放在dev-requirements.txt里，避免部署到Heroku）：

  dj-database-url>=2.0.0
  python-dotenv>=1.0.0  # 仅本地开发用，可选放dev依赖
  

• 修改settings.py的数据库配置部分：

  import os
  import dj_database_url
  from dotenv import load_dotenv
  
  # 加载本地.env文件（仅本地开发环境生效）
  load_dotenv()
  
  # 本地默认用SQLite（可选，也可以在.env里设置本地Postgres的DATABASE_URL）
  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.sqlite3',
          'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
      }
  }
  
  # 如果存在DATABASE_URL（本地.env或Heroku自动设置的），覆盖默认配置
  if os.getenv('DATABASE_URL'):
      DATABASES['default'] = dj_database_url.config(
          conn_max_age=600,
          ssl_require=True
      )
  

  这样本地开发时会读取.env里的DATABASE_URL（如果有的话），Heroku生产环境会自动读取平台生成的DATABASE_URL，完全不需要手动硬编码任何凭证。

3. 重新部署并测试

• 提交修改后的代码到Git：

  git add settings.py requirements.txt
  git commit -m "Fix database config for Heroku Postgres"
  git push heroku main
  

• 再次执行迁移命令：

  heroku run python src/manage.py migrate -a myapp
  

额外注意事项 #

• 本地开发不建议直接连接Heroku的生产数据库，容易误操作数据。推荐本地用SQLite或者自己搭建的Postgres实例，.env里只配置本地数据库的DATABASE_URL即可。
• 如果需要本地调试Heroku的生产数据，可以在Heroku仪表板的Postgres插件设置里，临时添加你的本地IP到允许访问列表，然后把Heroku的DATABASE_URL复制到本地.env里。

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