Docker-Compose场景下使用npm pg无法连接PostgreSQL容器

既然你已经通过psql在fibserver容器里成功连接到postgres服务，那问题肯定出在pg客户端的代码实现上，咱们一步步来排查：

1. 检查环境变量是否正确读取 #

首先确认你的代码有没有正确获取到docker-compose里设置的PostgreSQL连接参数。环境变量在Node.js里都是字符串类型，尤其是PGPORT，pg客户端需要它是数字类型，否则可能导致连接失败。

在你的fibserver代码开头添加日志，打印连接配置：

console.log('PostgreSQL Connection Config:', {
  user: process.env.PGUSER,
  password: process.env.PGPASSWORD,
  host: process.env.PGHOST,
  port: process.env.PGPORT,
  database: process.env.PGDATABASE
});

如果发现port是字符串，记得转成数字：

const { Client } = require('pg');

const client = new Client({
  user: process.env.PGUSER,
  password: process.env.PGPASSWORD,
  host: process.env.PGHOST,
  port: Number(process.env.PGPORT) || 5432, // 转成数字类型
  database: process.env.PGDATABASE
});

2. 确认pg客户端的连接方式是否正确 #

pg@7.x版本的客户端有两种使用方式：单客户端连接和连接池，两种方式的初始化和连接逻辑略有不同，别搞混了。

单客户端连接（适合单次操作） #

确保你正确调用了connect()，并且处理了异步逻辑：

const { Client } = require('pg');

const client = new Client(); // 自动读取环境变量，或者手动传上面的配置对象

async function initDB() {
  try {
    await client.connect();
    console.log('成功连接到PostgreSQL');
    // 执行查询测试
    const res = await client.query('SELECT NOW()');
    console.log('数据库时间:', res.rows[0]);
  } catch (err) {
    console.error('连接失败:', err);
    // 这里可以加你的重试逻辑
  }
}

initDB();

连接池（推荐用于服务端持续连接） #

如果你的服务需要频繁操作数据库，建议用连接池，它会自动管理连接生命周期：

const { Pool } = require('pg');

const pool = new Pool(); // 自动读取环境变量

async function testPool() {
  try {
    const res = await pool.query('SELECT NOW()');
    console.log('数据库时间:', res.rows[0]);
  } catch (err) {
    console.error('连接池查询失败:', err);
  } finally {
    // 如果不需要再用连接池，可以关闭
    // await pool.end();
  }
}

testPool();

3. 排查pg-native的兼容性问题 #

你安装了pg-native，它是pg的原生绑定版本，可能存在Docker环境下的编译或兼容性问题。可以尝试强制使用纯JS版本的pg客户端，看看是否解决问题：

// 在引入pg之前设置环境变量，强制使用纯JS客户端
process.env.PGCLIENT = 'pg';

const { Client } = require('pg');
// 后续连接逻辑不变

如果这样能成功连接，说明是pg-native的安装或适配问题，可以考虑暂时移除pg-native，或者重新编译它（在Dockerfile里添加编译依赖，比如build-essential、libpq-dev等）。

4. 调整连接超时时间 #

pg@7.x的默认连接超时是30秒，虽然你重试了10分钟，但也许单次连接的超时设置太短？可以手动延长超时时间：

const client = new Client({
  connectionTimeoutMillis: 60000, // 设置为60秒
  // 其他配置...
});

5. 优化Docker依赖顺序（可选） #

虽然你重试10分钟后还是失败，但可以优化docker-compose里的依赖条件，确保fibserver在postgres完全就绪后再启动：

fibserver:
  # ...其他配置
  depends_on:
    redis:
      condition: service_started
    postgres:
      condition: service_healthy # 等待postgres健康检查通过
    fibworker:
      condition: service_started

先从上面的1、2两点开始排查，这两个是最常见的问题点。如果还是不行，可以把你的pg客户端连接代码贴出来，这样能更精准定位问题。

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