如何在Spring Boot测试中使用3.1版本Docker Compose新特性？容器部署失败求助

1. 确认插件配置与版本匹配 #

先检查build.gradle里的插件引入是否正确，确保Spring Boot版本和docker-compose插件版本兼容：

plugins {
    id 'org.springframework.boot' version '3.2.0'
    id 'io.spring.dependency-management' version '1.1.4'
    id 'java'
    id 'org.springframework.boot.docker-compose' version '1.0.0' // 版本需对应Spring Boot主版本
}

2. 绑定测试任务与Docker Compose生命周期 #

在build.gradle中配置测试任务，让它依赖docker-compose的启动/停止动作，同时指定测试用的compose文件：

tasks.named('test') {
    // 测试启动前先拉起容器
    dependsOn 'dockerComposeUp'
    // 测试结束后停止容器
    finalizedBy 'dockerComposeDown'
    // 显式指定测试资源目录下的compose文件
    systemProperty 'spring.docker.compose.file', 'src/test/resources/docker-compose.yml'
}

3. 测试资源目录的配置补充 #

在src/test/resources/application.properties里添加docker-compose的启用配置，避免上下文启动时忽略文件：

spring.docker.compose.enabled=true
spring.docker.compose.file=classpath:docker-compose.yml
spring.docker.compose.startup.max-wait=5m # 可选，延长容器启动等待时长，避免超时

4. 测试类的注解配置 #

• 全栈集成测试用@SpringBootTest：

  @SpringBootTest
  class YourIntegrationTest {
      // 测试代码逻辑
  }
  

• 切片测试（如@DataJpaTest）需额外添加@AutoConfigureDockerCompose：

  @DataJpaTest
  @AutoConfigureDockerCompose
  class YourJpaTest {
      // 测试代码逻辑
  }
  

5. 排查问题的实用技巧 #

• 用docker-compose config命令本地验证src/test/resources/docker-compose.yml的语法是否合法；
• 运行测试时加上日志参数：gradle test -Dlogging.level.org.springframework.boot.docker.compose=DEBUG，查看日志里是否有文件未加载、容器启动失败的具体报错；
• 多模块项目需确认当前模块的src/test/resources目录被Gradle正确识别，可通过gradle test --info查看资源加载日志。

内容的提问来源于stack exchange，提问作者Диас Жапсар