Docker化微服务连接PostgreSQL容器异常：一个成功一个失败

可能的问题点及排查步骤 #

1. 检查PostgreSQL容器初始化状态 #

查看postgres-inventory容器日志，确认数据库是否成功创建、服务是否就绪：

docker logs postgres-inventory

重点关注：

• 是否出现database system is ready to accept connections日志
• 是否有CREATE DATABASE inventory-service的成功记录
• 是否存在用户权限相关错误

2. 验证服务间网络连通性 #

进入inventory-service容器，测试与postgres-inventory的网络连通性：

# 测试DNS解析是否正常
docker exec -it inventory-service ping postgres-inventory
# 测试5432端口是否可访问
docker exec -it inventory-service telnet postgres-inventory 5432

若ping不通则说明Docker网络存在问题；若telnet连接失败，可能是Postgres未在5432端口监听，或存在网络策略限制。

3. 确认Spring环境变量是否生效 #

检查inventory-service容器是否正确加载了Docker Compose配置的数据库URL：

docker exec -it inventory-service env | grep SPRING_DATASOURCE_URL

预期输出应为：SPRING_DATASOURCE_URL=jdbc:postgresql://postgres-inventory:5432/inventory-service。若输出不符，说明docker配置文件未正确激活，或配置优先级导致环境变量未覆盖本地配置。

4. 解决数据库未就绪时服务提前启动问题 #

depends_on仅保证容器启动顺序，不等待Postgres服务完全就绪。添加健康检查确保inventory-service在Postgres就绪后再启动：
修改docker-compose.yml中postgres-inventory配置：

postgres-inventory:
  container_name: postgres-inventory
  image: postgres
  environment:
    POSTGRES_DB: inventory-service
    POSTGRES_USER: matvey
    POSTGRES_PASSWORD: matvey
    PGDATA: /data/postgres
  volumes:
    - ./volumes/postgres-inventory:/data/postgres
  ports:
    - "5432:5432"
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U matvey -d inventory-service"]
    interval: 5s
    timeout: 5s
    retries: 5
  restart: unless-stopped

同步修改inventory-service的depends_on配置：

inventory-service:
  container_name: inventory-service
  image: zaxarleningod/inventory-service
  environment:
    - SPRING_PROFILES_ACTIVE=docker
    - SPRING_DATASOURCE_URL=jdbc:postgresql://postgres-inventory:5432/inventory-service
  depends_on:
    postgres-inventory:
      condition: service_healthy
    - discovery-server
    - api-gateway

5. 确认PostgreSQL端口监听状态 #

检查容器内Postgres是否在5432端口正常监听：

docker exec -it postgres-inventory netstat -tulpn | grep 5432

需确保输出显示Postgres进程监听0.0.0.0:5432。

常见错误对应解决方案 #

• Connection refused：优先排查网络连通性和Postgres服务就绪状态
• FATAL: database "inventory-service" does not exist：查看Postgres初始化日志，确认数据库创建是否失败，必要时手动进入容器创建数据库
• FATAL: password authentication failed for user "matvey"：核对环境变量与Spring配置的密码一致性，或检查Postgres用户初始化日志

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