Docker化Spring Boot 3应用连接外部PostgreSQL数据库问题排查

以下是针对性的排查和修复方案：

1. 检查数据库架构（Schema）配置 #

PostgreSQL默认使用public架构，但如果你的country表在其他架构下（比如dev或prod），应用需要明确指定架构：

• 在application.properties或application-prod.properties中添加：

  spring.jpa.properties.hibernate.default_schema=你的架构名
  

• 或者在实体类的@Table注解中指定：

  @Table(name = "country", schema = "你的架构名")
  public class CountryEntity {
      // ...
  }
  

2. 检查表名大小写匹配 #

PostgreSQL对表名大小写敏感的情况：

• 如果创建表时用了双引号（比如CREATE TABLE "Country" (...)），表名会保留大小写，此时应用里的实体类必须严格匹配：

  @Table(name = "\"Country\"") // 注意双引号要转义
  public class CountryEntity {
      // ...
  }
  

• 或者修改JPA的命名策略，强制使用小写或匹配数据库表名：

  spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
  # 或者用Spring的命名策略
  spring.jpa.hibernate.naming.physical-strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy
  

3. 验证数据源连接的数据库正确性 #

确认应用配置的数据库名称和DBeaver连接的完全一致：

• 检查application.properties中的数据库URL：

  spring.datasource.url=jdbc:postgresql://<host>:<port>/<正确的数据库名>?currentSchema=public
  

• 确保url里的数据库名和DBeaver连接的数据库名称完全相同，没有拼写错误。

4. 检查JPA实体类的映射配置 #

• 确认实体类的@Entity注解正确，@Table的name属性和数据库表名完全匹配（包括大小写、架构）。
• 如果用了Spring Data JPA的Repository，确保Repository接口关联的实体类正确：

  public interface CountryRepository extends JpaRepository<CountryEntity, Long> {
      // ...
  }
  

5. 排查Docker网络问题（仅DEV环境） #

如果是Docker化的应用，确保容器能正确访问PostgreSQL服务器：

• 检查docker-compose.yml中是否配置了正确的网络，比如如果PostgreSQL在宿主机，需要使用host.docker.internal作为主机名（Windows/macOS），或者宿主机的IP（Linux）：

  services:
    app:
      image: your-app-image
      environment:
        - SPRING_DATASOURCE_URL=jdbc:postgresql://host.docker.internal:5432/your-db
  

• 验证容器内是否能ping通PostgreSQL服务器，或者用psql命令测试连接：

  docker exec -it <your-app-container> psql -h <host> -U <user> -d <dbname>
  

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