使用Go的sqlx连接Docker中PostgreSQL时认证失败求助

我有如下连接字符串：

postgres://postgres:pw123@localhost:5432/mydb?sslmode=disable

使用Docker Compose执行以下命令连接数据库时可正常工作：

docker-compose exec postgresql psql "postgres://postgres:pw123@localhost:5432/mydb?sslmode=disable"

能成功连接并查询数据库，但使用sqlx连接时却出现错误：

db, err := sqlx.Connect("postgres", "postgres://postgres:pw123@localhost:5432/mydb?sslmode=disable")

报错信息：

pq: password authentication failed for user "postgres"

编辑补充：我尝试改用官方推荐格式的连接字符串，但问题依旧：

args := fmt.Sprintf("host=%s port=%s dbname=%s user=%s password=%s sslmode=%s", "localhost", "5432", "mydb", "postgres", "pw123", "disable")

db, err := sqlx.Connect("postgres", args)

可能的原因及解决方向 #

• 网络访问场景差异：docker-compose exec是直接进入Postgres容器内部执行命令，此时localhost指向容器自身，连接的是容器内的Postgres服务；而你的Go程序如果在宿主机运行，localhost指向宿主机，需要通过端口映射访问容器内的Postgres。如果容器的端口映射未正确配置，或者Postgres的pg_hba.conf仅允许容器内部IP段连接，就会导致身份验证失败。
  • 检查docker-compose.yml中Postgres服务的ports配置，确认是否有"5432:5432"这样的端口映射，确保宿主机能访问容器的5432端口。
  • 进入Postgres容器，查看/var/lib/postgresql/data/pg_hba.conf文件，添加允许宿主机IP连接的规则，比如：host all all 192.168.0.0/24 md5（替换成你的宿主机所在网段），或者临时添加host all all 0.0.0.0/0 md5用于测试（生产环境需严格限制IP）。修改后重启Postgres容器生效。
• Postgres用户连接权限限制：默认情况下，Postgres的postgres用户可能仅允许从localhost（容器内）登录，需要修改用户的连接权限。进入容器执行SQL命令：ALTER USER postgres WITH LOGIN CONNECTION LIMIT -1;，或者设置用户的连接来源为允许外部IP：ALTER USER postgres WITH HOST '0.0.0.0';。
• 容器网络互通问题：如果你的Go程序也运行在Docker容器中，需确保和Postgres容器处于同一个Docker网络（默认情况下docker-compose会创建专属网络），此时连接字符串中的host应该改为Postgres服务在docker-compose中的名称（比如postgresql），而不是localhost。
• 字符串转义问题：虽然你的密码是pw123没有特殊字符，但如果后续密码包含@、/等特殊字符，URL格式的连接字符串需要进行URL转义，不过当前场景可以排除这个因素。

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