Heroku部署应用触发PostgreSQL 5432套接字连接失败报错

这个报错的核心逻辑非常明确：部署到Heroku的应用仍在尝试通过本地Unix socket路径连接PostgreSQL服务，但Heroku运行应用的dyno容器内部默认不会启动本地Postgres进程，自然不存在/var/run/postgresql/.s.PGSQL.5432这个socket文件。
本地运行无异常是因为你的开发机本地安装了PostgreSQL服务，且默认监听了本地socket，和Heroku的线上运行环境逻辑完全不同。

• 确认Heroku Postgres附加组件已正确绑定
  进入Heroku控制台对应应用的Resources页面，确认已经成功provision Heroku Postgres附加组件。绑定完成后Heroku会自动为应用注入DATABASE_URL环境变量，格式为postgres://<用户名>:<密码>@<远程数据库地址>:5432/<库名>，这是线上环境唯一应该使用的数据库连接地址。
• 修正数据库连接逻辑，移除硬编码的本地配置
  检查项目中所有数据库相关配置，绝对不要硬编码localhost、本地socket路径这类仅本地生效的连接参数。线上环境必须读取DATABASE_URL环境变量获取完整连接信息。
  如果你使用Node.js生态的pg库作为连接驱动，参考如下配置即可：

  const { Pool } = require('pg')
  const isProduction = process.env.NODE_ENV === 'production'
  const pool = new Pool({
    connectionString: process.env.DATABASE_URL,
    // Heroku Postgres要求线上连接必须开启SSL
    ssl: isProduction ? { rejectUnauthorized: false } : false
  })
  

  如果你使用Prisma、Sequelize、TypeORM这类ORM框架，同样要将连接字符串指向DATABASE_URL环境变量，不要使用框架默认的本地连接兜底配置。
• 排查环境变量读取逻辑
  很多场景下报错是因为应用启动时没有成功读到DATABASE_URL，自动fallback到了框架默认的本地连接配置。你可以在Heroku应用的Settings - Config Vars页面确认DATABASE_URL确实已存在，也可以在应用启动逻辑中加临时日志（注意不要泄露完整连接串中的密码信息），确认进程启动时能正确获取到该环境变量。
• 排查构建阶段的误连接逻辑
  检查项目的构建脚本、postinstall脚本，不要在build阶段执行数据库连接、数据迁移操作。Heroku的构建阶段运行环境不会注入DATABASE_URL环境变量，如果在这个阶段触发数据库连接，必然会读取默认本地配置抛出上述socket报错。数据库迁移类操作需要配置到Heroku的release阶段脚本中执行，或者等应用启动完成后再运行。

修改配置后重新触发部署，通过Heroku日志命令查看实时运行日志，若不再出现socket文件不存在的报错，且数据库读写操作正常，即说明问题修复。

内容的提问来源于stack exchange，提问作者Adrián Horváth