Spring Boot测试删除MongoDB集合时应用上下文加载失败

我有一个基于Java 17的Spring Boot Maven MongoDB应用，需求是启动时删除集合。本地启动完全正常，但构建Docker镜像时，自动生成的contextLoads()测试抛出IllegalState: Failed to load Application context异常。

相关代码 #

1. 删除集合配置类（DataLoader） #

package com.jiraRestApi.datajiramongodb;

import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

@Component
public class DataLoader implements CommandLineRunner {

    private JiraIssueRepository jiraIssueRepository;

    protected DataLoader(JiraIssueRepository jiraIssueRepository){
        this.jiraIssueRepository = jiraIssueRepository;
    }

    @Override
    public void run(String... args) throws Exception {
        this.jiraIssueRepository.deleteAll();
    }
}

2. 主应用类 #

package com.jiraRestApi.datajiramongodb;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DataJiraMongodbApplication {

    public static void main(String[] args) {
        SpringApplication.run(DataJiraMongodbApplication.class, args);
    }
}

3. 自动生成的测试类 #

package com.jiraRestApi.datajiramongodb;

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
class DataJiraMongodbApplicationTests {
    @Test
    void contextLoads() {
    }
}

4. application.yaml配置 #

spring:
  data:
    mongodb:
      database: Jira-issues
      host: localhost
      port: 27017

我尝试过用mongoOperations.dropCollection(...)替换deleteAll()，但问题依旧。

问题原因与解决方案 #

核心原因 #

构建Docker镜像时会执行单元测试，此时测试环境没有运行MongoDB实例，CommandLineRunner在应用上下文加载阶段尝试连接localhost:27017的MongoDB，导致连接失败，最终触发上下文加载异常。

解决方法 #

方案1：测试阶段禁用数据清理逻辑

给测试类添加注解，排除DataLoader组件，避免测试时执行删除集合操作：

@SpringBootTest(exclude = DataLoader.class)
class DataJiraMongodbApplicationTests {
    @Test
    void contextLoads() {
    }
}

或者通过环境配置控制DataLoader的生效范围：

1. 给DataLoader添加@Profile注解，限定仅在非测试环境生效：

@Component
@Profile("!test")
public class DataLoader implements CommandLineRunner {
    // 原有代码不变
}

2. 测试类激活test环境：

@SpringBootTest
@ActiveProfiles("test")
class DataJiraMongodbApplicationTests {
    @Test
    void contextLoads() {
    }
}

方案2：测试时使用嵌入式MongoDB

添加嵌入式MongoDB依赖，让测试环境自动启动内存中的MongoDB实例，无需修改现有业务代码：
在pom.xml中加入以下依赖：

<dependency>
    <groupId>de.flapdoodle.embed</groupId>
    <artifactId>de.flapdoodle.embed.mongo</artifactId>
    <scope>test</scope>
</dependency>

Spring Boot会自动配置嵌入式MongoDB，测试时deleteAll()操作可以正常执行，上下文加载不会失败。

方案3：构建镜像时跳过单元测试

如果不需要在构建Docker镜像阶段执行测试，可在Maven构建命令中添加跳过测试参数：

mvn clean package -DskipTests
# 或跳过测试编译与执行
mvn clean package -Dmaven.test.skip=true

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