Docker部署的Micronaut应用无法连接PostgreSQL（连接池初始化异常）

问题背景 #

• PostgreSQL为独立实例，部署在外部主机/服务器
• Micronaut应用不同部署状态表现：
  • 独立Jar包/原生编译可执行文件：可正常连接数据库
  • 常规Docker镜像/Docker化原生编译镜像：启动时抛出HikariPool-1 - Exception during pool initialization，根源为java.net.SocketTimeoutException: Connect timed out，导致数据源初始化失败
• 相同网络配置下SpringBoot应用可正常连接数据库

排查与解决方案 #

1. 验证容器与PostgreSQL主机的网络连通性 #

• 测试容器内可达性：
  启动容器后执行以下命令，检查能否ping通PostgreSQL主机：

  docker exec -it <容器ID/名称> ping <DB_HOST地址>
  

  如果ping不通，需排查：

  • 主机防火墙是否允许Docker子网访问5432端口（添加规则允许默认Docker桥接子网172.17.0.0/16或自定义子网访问）
  • 若使用Mac/Windows Docker Desktop，主机地址需替换为host.docker.internal（Docker运行在虚拟机内，该地址会映射到物理主机）

• 用Host网络快速验证：
  运行容器时跳过Docker桥接网络隔离，直接使用主机网络：

  docker run --network host -p 8080:8080 <镜像ID>
  

  或在docker-compose.yml中配置：

  services:
    app:
      network_mode: host
      # 其他配置...
  

  若此模式下可正常连接，说明问题出在Docker桥接网络的路由或防火墙配置。

2. 调整PostgreSQL外部访问权限 #

• 修改postgresql.conf，允许监听所有地址：

  listen_addresses = '*'
  

• 修改pg_hba.conf，添加允许Docker子网访问的规则（以默认桥接子网为例）：

  host    all             all             172.17.0.0/16         md5
  

  修改后重启PostgreSQL服务。

3. 优化Micronaut数据库连接配置 #

• 在application.yml中增加Hikari连接池超时参数，避免因默认超时过短导致失败：

  datasources:
    default:
      # 原有配置...
      hikari:
        connection-timeout: 30000
        validation-timeout: 5000
  

• 验证环境变量传递：
  在容器内执行printenv，检查DB_HOST、DB_PORT等变量是否与docker-compose配置一致，避免拼写错误。

4. 原生编译镜像的特殊配置 #

原生镜像构建时需确保包含PostgreSQL驱动的必要资源和网络协议支持，在build.gradle中添加：

graalvmNative {
    binaries {
        main {
            resources {
                includes.add('org/postgresql/**')
            }
            buildArgs.add('--enable-url-protocols=http,https,jdbc,postgresql')
        }
    }
}

重新构建原生镜像后测试连接。

5. Docker-compose自定义网络配置 #

若不使用Host网络，创建自定义桥接网络并确保路由正确：

version: '3.5'
networks:
  work-network:
    driver: bridge
    ipam:
      config:
        - subnet: 192.168.200.0/24
services:
  app:
    environment:
      DB_HOST: 192.168.1.72
      # 其他环境变量...
    image: <镜像ID>
    ports:
      - "8080:8080"
    networks:
      - work-network

同时确保主机防火墙允许该自定义子网访问5432端口。

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