Docker环境下Golang连接PostgreSQL失败及成功原因咨询

当你在Docker Compose环境中遇到这个问题，核心原因是容器内的localhost指向逻辑与Docker网络服务发现机制的差异：

1. 容器内的localhost仅指向自身 #

在server容器中，localhost对应的是容器自身的网络栈，而非宿主机或postgres容器。当你的Go代码尝试连接localhost:5432时，实际是在访问server容器内部的5432端口，但该端口并未运行PostgreSQL服务，因此触发连接失败错误：

server | [error] failed to initialize database, got error failed to connect to host=localhost user=postgres database=yandex: dial error (dial tcp [::1]:5432: connect: cannot assign requested address)

2. Docker Compose的内置服务发现 #

Docker Compose会自动为所有启动的服务创建默认桥接网络，同时提供内置DNS解析：

• 你在docker-compose.yml中定义的服务名称（比如postgres）会被Docker DNS解析为对应容器的内部IP地址
• 容器之间可直接通过服务名称互相通信，无需依赖宿主机的端口映射

因此当你将DSN中的host=localhost改为host=postgres时，Go代码会通过Docker内部DNS找到postgres容器的IP，从而成功连接到该容器内运行的PostgreSQL服务。

补充说明 #

• 宿主机上能用localhost:5432访问数据库，是因为你配置了端口映射5432:5432，将容器端口映射到了宿主机对应端口
• 容器间通信不需要依赖端口映射，直接使用服务名称+容器内部端口即可（PostgreSQL默认端口为5432）

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