Node.js应用无法连接Azure Linux虚拟机上的远程PostgreSQL数据库（认证失败）

我目前碰到了一个棘手的问题：正在尝试把Node.js应用连接到运行在Azure Linux虚拟机上的远程PostgreSQL数据库。

用本地的PGAdmin通过SSL隧道连接这个远程库时一切正常——能成功连上服务器，看到所有数据库列表，甚至创建、删除数据库的操作都能同步到服务器上，毫无问题。

但把完全相同的凭据用到Node.js应用里时，却一直抛出认证错误：

error: password authentication failed for user "postgres"

我已经在服务器端的postgresql.conf里修改了监听地址，把listen_addresses从localhost改成了*，相关配置如下：

# - Connection Settings -

listen_addresses = '*'          # what IP address(es) to listen on;
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost'; use '*' for all

可能的原因及对应的解决办法 #

1. 密码特殊字符未转义

PGAdmin会自动处理密码里的特殊字符（比如@、#、$这类），但Node.js的数据库连接字符串如果直接使用这些字符，会被当成URL的一部分解析，导致实际传递给PostgreSQL的密码不对。

解决办法：

• 用encodeURIComponent()对密码进行转义后再拼接进连接字符串：

  const password = encodeURIComponent("你的postgres密码");
  const connectionString = `postgresql://postgres:${password}@服务器IP:端口/目标数据库名`;
  

• 或者改用连接对象的方式配置，避开URL解析的坑：

  const { Pool } = require('pg');
  const pool = new Pool({
    user: 'postgres',
    host: '你的服务器IP',
    database: '要连接的数据库名',
    password: '你的postgres密码',
    port: 5432, // 默认端口，改了的话对应调整
    ssl: {
      rejectUnauthorized: false // 如果你用的是自签名证书或者SSL隧道场景，可能需要开启这个选项
    }
  });
  

2. pg_hba.conf的访问控制规则未配置正确

你只修改了postgresql.conf的监听地址，但PostgreSQL的客户端访问权限是由pg_hba.conf控制的，很可能你的Node.js客户端所在的IP没有被允许访问。

解决办法：

1. 登录Azure Linux虚拟机，找到pg_hba.conf文件（通常路径是/var/lib/postgresql/[版本号]/main/或者/etc/postgresql/[版本号]/main/）
2. 添加一条允许你的本地IP（或者临时允许所有IP用于测试）的访问规则，比如：

   # 允许所有IP通过密码认证访问（仅测试用，生产环境建议限制具体IP）
   host    all             all             0.0.0.0/0               scram-sha-256
   

3. 重启PostgreSQL服务使配置生效：

   sudo systemctl restart postgresql
   

3. SSL配置和PGAdmin不一致

PGAdmin通过SSL隧道连接时可能自动处理了SSL验证逻辑，但Node.js的pg库默认的SSL配置可能和PGAdmin不匹配，这也会导致认证失败。

解决办法：

• 如果你是用SSL隧道连接，确保Node.js的SSL配置和PGAdmin一致，比如PGAdmin关闭了SSL证书验证的话，Node.js里也要设置ssl: { rejectUnauthorized: false }
• 如果是直接远程连接（非隧道），要确保PostgreSQL服务器的SSL配置正确，且Node.js客户端能获取到有效的SSL证书。

4. 凭据配置存在细微差异

有时候可能你在PGAdmin里用的是完整的用户名（比如带域名后缀），或者端口号和Node.js里配置的不一致，建议仔细核对：

• 确认用户名是postgres，注意大小写（PostgreSQL默认用户名是小写）
• 确认端口号是PostgreSQL默认的5432，如果修改过端口要对应调整
• 确认目标数据库名称正确，PGAdmin默认可能连接的是postgres数据库，Node.js里如果指定了不存在的库也会报错，但这里是认证错误，重点还是用户名、密码和访问控制规则。

备注：内容来源于stack exchange，提问作者user28052177