Docker部署的Spring Boot应用无法连接Docker中的Postgres数据库

出现Unable to determine Dialect without JDBC metadata报错，本质是Spring Boot无法通过JDBC连接获取PostgreSQL的元数据来自动识别Hibernate方言，本地能正常运行说明代码本身无问题，问题集中在Docker环境的网络或配置环节，以下是针对性解决步骤：

1. 修正Docker环境下的JDBC连接地址 #

本地运行时用localhost能访问宿主机映射的Postgres端口，但Docker容器内的localhost指向容器自身而非宿主机。正确配置方式：

• 将JDBC URL中的主机名替换为PostgreSQL容器的名称（比如启动Postgres时指定--name postgres-db，则URL写jdbc:postgresql://postgres-db:5432/your-db-name）
• 确保Spring Boot容器和PostgreSQL容器处于同一Docker网络，可创建自定义网络并让两个容器加入：

  docker network create app-network
  docker run --name postgres-db --network app-network -e POSTGRES_USER=xxx -e POSTGRES_PASSWORD=xxx -e POSTGRES_DB=xxx -p 5432:5432 postgres:16.2
  docker run --name spring-app --network app-network -p 8080:8080 your-spring-boot-image
  

2. 显式指定Hibernate方言 #

关闭自动检测逻辑，直接在配置文件中指定适配PostgreSQL的方言，避免因元数据获取失败引发报错：

• 若使用application.properties：

  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
  

• 若使用application.yml：

  spring:
    jpa:
      properties:
        hibernate:
          dialect: org.hibernate.dialect.PostgreSQLDialect
  

  注：PostgreSQL 10及以上版本也可使用org.hibernate.dialect.PostgreSQL10Dialect，最新版PostgreSQLDialect已兼容高版本数据库。

3. 验证PostgreSQL容器状态与网络连通性 #

• 查看PostgreSQL容器日志，确认数据库初始化完成、无启动异常：

  docker logs postgres-db
  

• 进入Spring Boot容器，测试与PostgreSQL容器的网络连通性：

  docker exec -it spring-app ping postgres-db
  

• 若Spring Boot容器内装有psql工具，可直接测试数据库连接：

  docker exec -it spring-app psql -U your-user -d your-db -h postgres-db
  

4. 检查配置参数一致性 #

确保Spring Boot配置中的spring.datasource.username、spring.datasource.password与PostgreSQL容器启动时设置的POSTGRES_USER、POSTGRES_PASSWORD完全匹配，同时POSTGRES_DB要和JDBC URL中的数据库名称一致。

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