Heroku部署Dash应用无法连接外部PostgreSQL数据库问题求助

问题核心原因 #

你遇到的报错本质是你的应用没有读取到Heroku配置的DATABASE_URL环境变量，默认尝试连接Heroku dyno本地的PostgreSQL服务，而Heroku运行环境默认没有安装本地PostgreSQL，因此找不到Unix域套接字文件抛出错误。另外你提到的pg_lsclusters命令无输出属于正常情况，该命令用于查看本地安装的PostgreSQL集群，你使用外部数据库无需在Heroku dyno中安装PostgreSQL服务端，不用关注该命令输出。

修复步骤 #

• 修正连接参数读取逻辑
  Heroku生产环境不会读取项目内的.env文件，该文件仅用于本地开发。你需要调整代码逻辑，优先读取系统环境变量中的DATABASE_URL，本地开发时再 fallback 到.env配置。
  以Python代码为例，参考实现：

  import os
  from urllib.parse import urlparse
  
  # 生产环境读取Heroku Config Vars中的DATABASE_URL
  if "DATABASE_URL" in os.environ:
      parsed_url = urlparse(os.getenv("DATABASE_URL"))
      db_config = {
          "user": parsed_url.username,
          "password": parsed_url.password,
          "host": parsed_url.hostname,
          "port": parsed_url.port,
          "database": parsed_url.path[1:]
      }
  # 本地开发环境加载.env文件
  else:
      from dotenv import load_dotenv
      load_dotenv()
      db_config = {
          "user": os.getenv("user"),
          "password": os.getenv("password"),
          "host": os.getenv("host"),
          "port": 5432,
          "database": os.getenv("database")
      }
  

  如果使用SQLAlchemy，可直接将DATABASE_URL作为参数传入create_engine，无需拆分参数。

• 验证环境变量配置
  部署后可通过heroku run bash进入dyno运行环境，执行echo $DATABASE_URL，确认返回值与你配置的外部数据库连接地址一致。

• 网络权限校验
  连接参数问题修复后如果出现连接拒绝错误，需要将Heroku dyno的出口IP段添加到你自有PostgreSQL数据库的访问白名单中。你也可以在dyno中安装psql客户端直接验证连接：

  apt update && apt install postgresql-client -y
  psql $DATABASE_URL
  

  该命令可正常进入数据库交互界面则说明网络、权限、连接参数均无问题，剩余问题均为应用代码逻辑导致。

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