Docker Compose配置后PostgreSQL未按预期暴露指定端口问题咨询

核心认知澄清 #

PostgreSQL官方镜像启动后，容器内的数据库进程永远默认监听5432端口。你在容器日志里看到的5432监听记录是容器内部的运行状态，和你配置的宿主机对外端口没有关系，这不是配置没生效的表现。

注意：修正完成后，两个PostgreSQL容器的日志依然会显示listening on IPv4 address "0.0.0.0", port 5432，这是容器内部进程的状态打印，和宿主机对外暴露的端口完全无关，不是配置失效的表现。

现有配置的核心错误 #

• 端口映射规则完全错配
  Docker Compose的ports配置格式为 宿主机暴露端口:容器内服务端口。你之前两个数据库的端口配置写的是"3336:3306"、"3307:3306"，存在两个问题：
  1. 3306是MySQL的默认端口，PostgreSQL镜像根本不会在这个端口启动服务
  2. 该配置实际是将宿主机的3336、3307端口，转发到容器内无服务监听的3306端口，完全无法连通
     后续修改的"5432:3336"同样错位，依然是把宿主机5432转发到容器内无人监听的3336端口
• 容器间通信的连接配置错误
  Docker Compose默认会给所有服务创建一个内部互通网络，服务之间通信时，直接使用服务名作为主机名、对应服务的容器内部端口即可，不需要走宿主机端口，也不需要使用host.docker.internal。
  你之前在应用服务环境变量里配置的DATABASE_HOST=host.docker.internal、DATABASE_PORT=3336/3307，相当于让容器绕回宿主机网络访问数据库，不仅增加网络链路长度，还容易因为宿主机防火墙配置导致连接失败
• 连接串端口错误
  两个PostgreSQL容器内部服务端口都是5432，你在连接串里写的db:3336、user-service-db:3307，本质是试图连接容器内不存在的端口，之前连接成功只是因为应用侧的配置兼容了默认5432端口。

修正后的正确配置 #

按以下顺序调整配置，调整完成后执行docker-compose down -v清理旧的容器网络与残留配置，再重启服务即可：

1. 调整两个数据库服务的端口映射，对应宿主机端口转发到容器内PostgreSQL的5432端口：

   # api-gateway配套的数据库
   db:
     image: postgres
     restart: always
     environment:
       - POSTGRES_DB=dbname
       - POSTGRES_USER=postgres
       - POSTGRES_PASSWORD=postgres
     ports:
       - "3336:5432" # 宿主机3336 -> 容器内5432
   # 用户服务配套的数据库
   user-service-db:
     image: postgres
     restart: always
     environment:
       - POSTGRES_DB=dbname
       - POSTGRES_USER=postgres
       - POSTGRES_PASSWORD=postgres
     ports:
       - "3307:5432" # 宿主机3307 -> 容器内5432
   

2. 调整两个应用服务的数据库相关环境变量，走Docker内部网络直连数据库：

   # server-api-getaway的环境变量
   environment:
     - CHOKIDAR_USEPOLLING=true
     - REDIS_URL=redis://cache
     - DATABASE_URL=postgres://postgres:postgres@db:5432/dbname
     - POSTGRES_DB=dbname
     - POSTGRES_USER=postgres
     - POSTGRES_PASSWORD=postgres
     - PORT=7100
   # server-user-service的环境变量
   environment:
     - CHOKIDAR_USEPOLLING=true
     - REDIS_URL=redis://cache
     - DATABASE_URL=postgres://postgres:postgres@user-service-db:5432/dbname
     - POSTGRES_DB=dbname
     - POSTGRES_USER=postgres
     - POSTGRES_PASSWORD=postgres
     - PORT=7000
   

效果验证 #

配置生效后：

• 宿主机上可通过localhost:3336连接第一个数据库，通过localhost:3307连接第二个数据库，实现两个数据库对外端口独立的需求
• 应用服务在Docker内部网络中，直接通过服务名+5432端口连接对应数据库，网络链路稳定
• 无需关注容器日志里的5432监听提示，该状态为正常运行表现

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