Windows主机连接WSL2后端Docker容器内PostgreSQL服务时密码认证失败（容器内连接正常）

这种容器内连接正常但外部Windows主机连不上的密码认证问题确实挺让人头疼的，结合你已经完成的排查（确认环境变量、容器内验证有效、重装Docker和WSL），我整理几个针对性的排查方向和解决办法：

• 检查PostgreSQL的远程连接认证策略（pg_hba.conf）
  虽然你用127.0.0.1发起连接，但从Windows主机到Docker容器的请求，在PostgreSQL服务端可能被识别为非本地连接。默认的pg_hba.conf可能只允许容器内的本地连接使用密码认证，需要调整为允许外部IP段的认证规则：

  1. 进入容器终端：

     docker exec -it crm-db bash
     

  2. 编辑pg_hba.conf配置文件（PostgreSQL 17版默认路径）：

     vi /var/lib/postgresql/data/pg_hba.conf
     

  3. 找到类似以下的本地连接规则行：

     host    all             all             127.0.0.1/32            scram-sha-256
     

  4. 修改为允许所有IP段的密码认证：

     host    all             all             0.0.0.0/0            scram-sha-256
     

  5. 重启容器使配置生效：

     docker restart crm-db
     

  之后再尝试从Windows主机发起连接。

• 验证WSL2端口转发与端口占用
  Docker Desktop的端口转发偶尔会出现异常，或者Windows主机上有其他进程占用5432端口：

  1. 在Windows命令行中检查5432端口的占用情况：

     netstat -ano | findstr :5432
     

     如果输出中有非Docker相关的进程ID，结束该进程后重试连接。
  2. 若端口无冲突，尝试更换容器映射的端口，比如修改启动命令为：

     docker run --name crm-db -e POSTGRES_USER=ayushpandey0001 -e POSTGRES_PASSWORD=pass123 -e POSTGRES_DB=crm_db -p 5433:5432 -d postgres:latest
     

     然后用新端口在Windows上连接：

     psql -h 127.0.0.1 -p 5433 -U ayushpandey0001 -d crm_db
     

• 使用WSL2的实际IP地址连接
  有时候127.0.0.1的端口转发会存在缓存或路由问题，直接使用WSL2的虚拟IP可能绕过这个问题：

  1. 打开WSL终端，获取WSL2的IP地址：

     hostname -I
     

     通常会输出类似192.168.1.100的私有IP。
  2. 在Windows主机上用该IP发起连接：

     psql -h 192.168.1.100 -p 5432 -U ayushpandey0001 -d crm_db
     

  同时可以临时关闭WSL的防火墙测试：sudo ufw disable，排除防火墙拦截的可能。

• 重置用户密码（排除容器初始化异常）
  虽然你已经确认了环境变量，但容器初始化时可能存在偶发异常导致密码未正确写入，直接在容器内重置密码：

  1. 进入容器的PostgreSQL命令行：

     docker exec -it crm-db psql -U ayushpandey0001 -d crm_db
     

  2. 执行密码重置SQL：

     ALTER USER ayushpandey0001 WITH PASSWORD 'newpass123';
     \q
     

  3. 在Windows主机上用新密码连接：

     psql -h 127.0.0.1 -p 5432 -U ayushpandey0001 -d crm_db -W
     

     输入newpass123尝试登录。

内容来源于stack exchange