使用Spring Boot、JUnit5和Testcontainers测试MongoDB仓库时遇到问题

嘿，看起来你在配置Spring Boot + JUnit5 + Testcontainers测试MongoDB仓库的时候卡壳了，我来帮你梳理下可能的问题点和修正方案！

首先，我先看了你贴的代码片段，发现几个可能导致仓库测试出问题的地方，咱们一步步来调整：

一、先修正你的测试配置类 #

原配置里有几个小问题，比如注解的使用、容器启动逻辑、Bean配置的完整性，我给你整理了一个完整可用的版本：

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import org.junit.jupiter.api.BeforeAll;
import org.springframework.boot.test.context.TestConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Primary;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.SimpleMongoClientDbFactory;
import org.springframework.data.mongodb.gridfs.GridFsOperations;
import org.springframework.data.mongodb.gridfs.GridFsTemplate;
import org.testcontainers.containers.MongoDBContainer;
import org.testcontainers.containers.wait.strategy.Wait;

@TestConfiguration
public class MongoTestConfig {

    // 静态容器实例，让所有测试共享同一个Mongo容器，提升测试效率
    static MongoDBContainer mongoDBContainer = new MongoDBContainer("mongo:4.4.2")
            .withExposedPorts(27017)
            // 双重等待策略：先等端口开放，再等MongoDB启动完成的日志，确保容器真的就绪
            .waitingFor(Wait.forListeningPort())
            .waitingFor(Wait.forLogMessage(".*waiting for connections on port.*", 1));

    // JUnit5的@BeforeAll静态方法，确保容器在所有测试执行前启动
    @BeforeAll
    static void startMongoContainer() {
        mongoDBContainer.start();
    }

    // 配置测试专用的MongoClient，指向Testcontainers的Mongo实例
    @Bean
    @Primary
    public MongoClient mongoClient() {
        // 直接用容器提供的连接地址，不用手动拼，避免出错
        return MongoClients.create(mongoDBContainer.getReplicaSetUrl());
    }

    // 配置测试专用的MongoTemplate
    @Bean
    @Primary
    public MongoTemplate mongoTemplate(MongoClient mongoClient) {
        // 指定测试用的数据库名，比如testdb
        return new MongoTemplate(new SimpleMongoClientDbFactory(mongoClient, "testdb"));
    }

    // 如果你的测试用到GridFS，就保留这个Bean，否则可以删掉
    @Bean
    @Primary
    public GridFsOperations gridFsOperations(MongoTemplate mongoTemplate) {
        return new GridFsTemplate(mongoTemplate.getDbFactory(), mongoTemplate.getConverter());
    }
}

二、调整测试类的注解 #

你原来把@SpringBootTest和@TestConfiguration放在同一个类里，这容易让Spring的配置加载逻辑混乱。正确的做法是把配置类单独放，然后在测试类里引入它：

import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.annotation.Import;
import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;

@SpringBootTest
// 引入咱们的测试Mongo配置
@Import(MongoTestConfig.class)
// 如果你的仓库不在默认扫描路径下，就加上这个注解指定仓库包路径
@EnableMongoRepositories(basePackages = "com.yourpackage.repository")
public class YourMongoRepositoryTest {

    // 注入你要测试的Mongo仓库
    // @Autowired
    // private UserRepository userRepository;

    // 写你的测试方法就好啦
    // @Test
    // void testRepositoryOperations() {
    //     // 测试逻辑
    // }
}

三、几个容易踩坑的排查点 #

• 确保@Primary注解加上了：这个注解会让Spring优先使用测试配置里的Mongo相关Bean，而不是你应用主配置里的本地Mongo连接，这是测试不连本地库的关键！
• 检查依赖是否齐全：如果是Maven，确保Testcontainers的依赖已经加到pom.xml的test scope里：

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

• 仓库接口要正确继承MongoRepository：比如public interface UserRepository extends MongoRepository<User, String>，这样Spring才能自动实现仓库的代理类。

按照这个调整后，你的测试应该就能正确连接Testcontainers的Mongo实例，测试仓库的操作了。

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