Node.js应用通过Jenkins构建时连接本地PostgreSQL数据库报错咨询

1 校验PostgreSQL侧用户配置有效性 #

• 以超级用户（默认postgres）登录PostgreSQL终端，执行\du确认jenkins用户已存在：
  • 若不存在执行创建命令：CREATE USER jenkins WITH PASSWORD '你预设的jenkins用户密码';
  • 同时给用户授予对应业务数据库权限：GRANT ALL PRIVILEGES ON DATABASE 你的业务数据库名 TO jenkins;

2 修正pg_hba.conf配置规则 #

• 你新增的host all jenkins 0.0.0.0/0 md5规则需要放在其他同范围的拦截规则之前，pg_hba.conf是从上到下匹配的，前面有匹配的规则会直接生效，后面的规则不执行
• 若Jenkins和PostgreSQL部署在同一台服务器，默认优先走Unix套接字连接，你添加的是TCP连接规则，需要补充本地套接字访问规则：

  local    all             jenkins             md5
  

• 若使用ipv6访问，补充ipv6规则：

  host    all             jenkins         ::1/128               md5
  

• 所有配置修改完成后，必须重启PostgreSQL服务生效，示例命令：
  • Ubuntu/Debian：sudo systemctl restart postgresql
  • CentOS/RHEL：sudo systemctl restart postgresql-<你的pg大版本号>

3 校验Jenkins构建环境的连接参数 #

• 确认Node.js代码中读取的数据库用户名、密码、地址、端口、库名配置和PostgreSQL侧实际配置完全一致，优先检查Jenkins全局/任务级环境变量是否配置错误，避免硬编码密码和实际不一致的问题
• 可临时在构建脚本中添加调试逻辑，打印连接参数（调试完成后删除，避免密码泄露）：

  // 放在数据库连接初始化代码之前
  console.log('数据库连接参数：', {
    user: process.env.PG_USER,
    host: process.env.PG_HOST,
    database: process.env.PG_DATABASE,
    password: process.env.PG_PASSWORD ? '已配置' : '未配置',
    port: process.env.PG_PORT
  })
  

• 若连接地址配置为localhost，可改为127.0.0.1测试，避免部分系统优先走ipv6地址导致匹配不到规则

4 本地模拟连接验证 #

在Jenkins部署的服务器上直接用psql命令测试jenkins用户的连接有效性：

psql -U jenkins -d 你的业务数据库名 -h 127.0.0.1

输入预设密码后如果能正常登录，说明PostgreSQL侧配置正常，问题出在Node.js代码或Jenkins环境变量配置；如果仍报密码错误，回到前两步重新检查PostgreSQL配置。

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