Docker构建Spring Boot项目：单元测试因数据库容器未运行失败的解决办法

你不需要必须运行真实的Postgres容器才能通过构建，以下是几种最优解决办法：

1. 构建时跳过单元测试 #

mvn package命令默认会执行所有单元测试，你可以修改Dockerfile中的构建命令，添加参数跳过测试：

RUN mvn package -DskipTests

或者完全跳过测试类的编译：

RUN mvn package -Dmaven.test.skip=true

这种方式适合快速构建镜像，单元测试可以放在CI流水线的单独阶段执行，避免构建过程依赖外部服务。

2. 使用嵌入式数据库隔离单元测试 #

在测试环境使用轻量的嵌入式数据库（如H2），和生产环境的Postgres解耦：

• 在src/test/resources下创建application-test.properties：

  spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
  spring.datasource.driver-class-name=org.h2.Driver
  spring.datasource.username=sa
  spring.datasource.password=
  spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
  

• 在测试类上激活测试配置：

  @SpringBootTest
  @ActiveProfiles("test")
  public class YourTestClass {
      // 测试逻辑
  }
  

这样构建时单元测试会自动使用H2数据库，无需依赖外部Postgres容器。

3. 用Testcontainers自动启动临时Postgres容器 #

如果需要单元测试贴近生产环境的数据库行为，可以使用Testcontainers在测试阶段自动启动临时Postgres容器：

• 在pom.xml中添加Testcontainers依赖：

  <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 YourDbTestClass {
      @Container
      static PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15-alpine")
              .withDatabaseName("myApp")
              .withUsername("uname")
              .withPassword("pword");
  
      @DynamicPropertySource
      static void setDatasourceProperties(DynamicPropertyRegistry registry) {
          registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
          registry.add("spring.datasource.username", postgresContainer::getUsername);
          registry.add("spring.datasource.password", postgresContainer::getPassword);
      }
  
      // 数据库相关测试方法
  }
  

构建时Testcontainers会自动拉取Postgres镜像、启动容器，测试完成后自动销毁容器，全程无需手动干预。

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