Spring Boot集成测试时数据库无法自动创建的问题求助

我之前做Spring Boot集成测试的时候也碰到过一模一样的问题，折腾了好一会儿才搞定，给你梳理几个排查方向和解决方案，应该能帮到你：

先搞清楚一个关键误区：Hibernate的ddl-auto不负责创建数据库本身！ #

很多人会误以为spring.jpa.hibernate.ddl-auto=create会自动创建数据库，但其实它只负责在已经存在的数据库里创建表结构。PostgreSQL的JDBC驱动本身也不支持像MySQL那样的createDatabaseIfNotExist=true参数，所以如果你的目标数据库还没手动创建，第一步就会失败。

一步步排查解决： #

1. 先确认基础配置是否正确

• 检查你的测试配置文件（比如src/test/resources/application-test.properties）里的数据库连接信息：

  # URL格式要正确，注意这里的your_db_name必须是PostgreSQL中已经存在的数据库
  spring.datasource.url=jdbc:postgresql://localhost:5432/your_db_name
  spring.datasource.username=your_username
  spring.datasource.password=your_password
  # 确保ddl-auto设置正确
  spring.jpa.hibernate.ddl-auto=create
  # 打开SQL日志，方便排查
  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

• 验证PostgreSQL服务是否正常启动，并且你用的用户名有访问目标数据库、创建表的权限（可以用pgAdmin登录试试，手动执行CREATE TABLE看是否能成功）。

2. 检查测试类的配置是否生效

• 测试类上必须加@SpringBootTest注解，确保加载完整的Spring上下文：

  @SpringBootTest
  // 如果用了单独的测试配置文件，加上这个注解指定路径
  @TestPropertySource(locations = "classpath:application-test.properties")
  public class YourIntegrationTest {
      // 测试方法
  }
  

• 如果你用了@Transactional注解，测试结束后会自动回滚事务，这时候表结构会被回滚，但数据库本身应该是存在的；如果连数据库连接都失败，那肯定是数据库没创建的问题。

3. 检查依赖是否齐全

• 确保你的构建文件里有PostgreSQL驱动和Spring Data JPA的依赖：
  Maven：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  <dependency>
      <groupId>org.postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <scope>test</scope>
  </dependency>
  

  Gradle：

  implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
  testImplementation 'org.postgresql:postgresql'
  

4. 用日志定位问题

启动测试后，重点看日志里的这几个部分：

• 有没有数据库连接失败的错误（比如FATAL: database "your_db_name" does not exist），如果有，先手动在PostgreSQL里创建这个数据库；
• 有没有Hibernate输出的DDL语句，如果没有，可能是实体类没被Spring扫描到（检查实体类是否在主启动类的包下，或者用@EntityScan注解指定扫描路径）。

5. 更优雅的解决方案：用Testcontainers自动管理测试数据库

如果不想每次手动创建数据库，推荐用Testcontainers，它会在测试时启动一个临时的PostgreSQL容器，自动创建数据库，测试结束后销毁，非常适合集成测试：

• 先添加Testcontainers的依赖：
  Maven：

  <dependency>
      <groupId>org.testcontainers</groupId>
      <artifactId>postgresql</artifactId>
      <scope>test</scope>
  </dependency>
  <dependency>
      <groupId>org.testcontainers</groupId>
      <artifactId>junit-jupiter</artifactId>
      <scope>test</scope>
  </dependency>
  

• 然后在测试类里配置：

  @SpringBootTest
  @Testcontainers
  public class YourIntegrationTest {
  
      // 启动一个PostgreSQL 15的容器
      @Container
      private static final PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15")
              .withDatabaseName("test_db")
              .withUsername("test_user")
              .withPassword("test_pass");
  
      // 动态注入数据库连接配置
      @DynamicPropertySource
      static void setDatabaseProperties(DynamicPropertyRegistry registry) {
          registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
          registry.add("spring.datasource.username", postgresContainer::getUsername);
          registry.add("spring.datasource.password", postgresContainer::getPassword);
          registry.add("spring.jpa.hibernate.ddl-auto", () -> "create");
      }
  
      // 你的测试方法
      @Test
      void testSomething() {
          // ...测试逻辑
      }
  }
  

  这样每次测试都会自动创建全新的数据库，完全不用管本地的PostgreSQL配置，也不会污染本地数据。

备注：内容来源于stack exchange，提问作者selvi