Windows下Docker部署PostgreSQL Node.js连接报密码认证失败问题

你遇到的场景和你推断的Windows兼容性问题相关性很低，核心是端口占用导致的连接错位，具体拆解如下：

根本原因 #

你启动Docker容器时配置的-p 5432:5432端口映射，实际没有生效：你的Windows宿主机本地早就有一个常驻安装的PostgreSQL服务，提前占用了5432端口。
Windows版本的Docker Desktop在端口被占时，很多时候不会直接抛出启动失败的错误，只会静默跳过端口绑定步骤，容器本身是正常运行的。这就导致：

• 你exec进入Docker容器内部用psql操作时，连的是容器内配置正确的PostgreSQL实例，所以一切正常
• 你的Node.js程序访问localhost:5432时，实际连接到的是宿主机本地那个旧的PostgreSQL实例，而这个实例的postgres用户密码和你在Docker环境变量里设置的testpw不匹配，因此触发密码认证失败的报错

快速验证 #

• 查看容器实际端口绑定状态，执行docker port dev-postgres，如果没有输出任何端口映射规则，就说明绑定失败了
• 查看本地5432端口的占用进程，Windows命令行执行netstat -ano | findstr :5432，输出结果里的PID对应的进程，基本就是你本地安装的PostgreSQL服务

修复步骤 #

1. 如果你不想改动本地已有的PostgreSQL服务，直接给Docker容器换一个未被占用的宿主机端口（比如5433），重新启动容器：

   docker run -d --name dev-postgres -e POSTGRES_PASSWORD=testpw -p 5433:5432 postgres
   

2. 调整Node.js的连接串，把端口替换为5433即可：

   const connectionString = "postgresql://postgres:testpw@localhost:5433/postgres";
   

3. 如果你希望继续使用5432端口，直接停掉本地占用5432端口的PostgreSQL服务，再重新启动Docker容器完成端口绑定即可

代码层面的小优化 #

你当前的代码没有给client.connect()加错误捕获，所以连接失败时会触发Node.js的未处理Promise拒绝警告，顺手补全错误处理逻辑就能避免这类崩溃提示：

const { Client } = require("pg");
const connectionString = "postgresql://postgres:testpw@localhost:5433/postgres";

const client = new Client({
  connectionString,
});

client.connect()
  .then(() => client.query("SELECT $1::text as message", ["Hello world!"]))
  .then(res => console.log(res.rows[0].message))
  .catch(err => console.error("执行出错：", err))
  .finally(() => client.end());

补充：和Linux环境下端口占用直接导致容器启动失败的行为不同，Windows Docker Desktop的静默端口绑定失败特性，是很多人遇到这类“容器内正常、外部连不上”问题的核心诱因。

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