Docker Compose容器间无法用映射端口连接的原理与方案咨询

一、快速修复当前连接问题 #

你的核心问题是连接字符串误用了宿主机映射端口5433，而非PostgreSQL容器的内部端口5432。修改连接字符串的Port参数即可解决：

Server=avaliacaomestradoapi-db;User ID=postgres;Password=postgres;Port=5432;Database=avaliacaomestrado;Integrated Security=true;Pooling=true;Maximum Pool Size=1024;Timeout=300

你之前尝试的操作均无效：

• Postgres容器默认已监听所有内网地址（listen_addresses='*'），无需额外配置；
• expose: 5433仅用于声明端口，既不会修改容器内部服务的监听端口，也不影响端口映射规则。

二、容器间通信端口机制原理 #

Docker的ports: 宿主机端口:容器内部端口是宿主机层面的网络转发规则，通过iptables实现：

1. 外部应用（如DBeaver）从宿主机访问5433时，iptables会把请求转发到PostgreSQL容器的内部5432端口；
2. 同一Docker网络内的容器直接通过内网IP或服务名通信，不会经过宿主机的端口转发规则。此时容器内的PostgreSQL仅在5432端口监听，用5433发起连接自然会被拒绝——该端口在容器内无服务监听。

总结规则：

• 宿主机/外部应用 → 使用**映射端口（5433）**访问；
• 同一网络内的容器 → 使用**容器内部端口（5432）**访问。

三、可行的替代方案 #

1. 标准方案（推荐） #

保持容器间用内部端口+服务名通信，这是Docker Compose原生的通信方式，稳定高效。连接字符串统一使用服务名（postgresDB）和内部端口5432即可。

2. 借助宿主机映射端口（不推荐） #

若必须使用映射端口，可让容器连接Docker提供的宿主机别名host.docker.internal，连接字符串修改为：

Server=host.docker.internal;User ID=postgres;Password=postgres;Port=5433;Database=avaliacaomestrado;Integrated Security=true;Pooling=true;Maximum Pool Size=1024;Timeout=300

此方式依赖宿主机网络配置，可靠性低于容器间直接通信，仅作为特殊场景备选。

3. 统一内外端口 #

将PostgreSQL的端口映射改为5432:5432，这样外部应用和容器内部都使用5432端口，连接字符串可统一。需注意宿主机的5432端口不能被其他进程占用。

内容的提问来源于stack exchange，提问作者Sérgio Neto