Heroku部署PostgreSQL应用时Knexjs连接报无pg_hba.conf条目错误

核心报错成因 #

• 触发 no pg_hba.conf entry 的根因：Heroku 托管的 PostgreSQL 实例默认强制要求所有连接启用 SSL，当前 Knex 配置直接读取DATABASE_URL环境变量、未显式开启SSL，连接时被数据库以非加密状态拦截，匹配不到对应的访问规则。
• 日志中的未处理Promise警告属于次生问题：代码中数据库查询的异步逻辑没有做错误捕获，数据库连接失败时抛出的拒绝Promise没有被处理，才会触发Node.js的运行时警告。

落地修复步骤 #

1. 调整Knex连接配置适配Heroku环境 #

替换原有连接配置，根据运行环境自动开关SSL：

import knex from 'knex'

const database = knex({
    client: 'pg',
    connection: process.env.DATABASE_URL,
    // 生产环境开启SSL，跳过自签名证书校验；本地开发关闭SSL
    ssl: process.env.NODE_ENV === 'production' ? { rejectUnauthorized: false } : false
})

const retrieve = async () => {
    // 增加错误捕获逻辑，消除未处理Promise警告
    try {
        const users = await database.select().from('users')
        return users
    } catch (error) {
        console.error('数据库查询执行失败', error.message)
        throw error
    }
}

export default retrieve

配置说明：

• 生产环境开启SSL时设置rejectUnauthorized: false，是因为Heroku的PostgreSQL使用平台内部自签名证书，默认开启证书校验会出现证书不受信任的额外报错。
• 本地开发环境关闭SSL，避免额外配置影响本地数据库连接流程。
• 给异步查询方法增加try/catch错误捕获，从根源上消除未处理Promise拒绝的运行时警告。

2. 修复验证 #

• 修改配置后重新部署应用，观察日志中原先的SSL off连接报错是否消失。
• 临时在接口返回逻辑中打印查询到的用户列表，确认数据库读写连通性正常。
• 不要在生产环境硬编码数据库连接参数，始终使用平台自动注入的DATABASE_URL环境变量，避免数据库凭据轮换后出现连接失效。

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