Flapdoodle Embedded Mongo 集成测试指定端口不生效 启动为随机端口

我正在使用Flapdoodle's Embedded Mongo为我的Spring Boot应用运行集成测试。
我编写的测试代码如下：

@SpringBootTest(classes = Application.class)
@TestMethodOrder(OrderAnnotation.class)
class IntegrationTests {

    @BeforeAll
    static void setup() throws Exception {
        String ip = "localhost";
        int port = 65000;

        IMongodConfig mongodConfig = new MongodConfigBuilder().version(Version.Main.PRODUCTION)
                .net(new Net(ip, port, Network.localhostIsIPv6())).build();

        MongodStarter starter = MongodStarter.getDefaultInstance();
        mongodExecutable = starter.prepare(mongodConfig);
        mongodExecutable.start();

        mongoTemplate = new MongoTemplate(MongoClients.create(String.format(CONNECTION_STRING, ip, port)), "test");
    }
}

但每次启动MongoDB服务时实际监听的都是随机端口，运行日志如下：

[2021-03-16T01:41:26.026Z] [com.mongodb.diagnostics.logging.SLF4JLogger] [main] [71] [INFO ] Opened connection [connectionId{localValue:4, serverValue:2}] to localhost:55359

我已经尝试设置不同的端口值，但配置始终没有生效。
想咨询导致我的端口配置未被识别生效的原因，该如何解决固定Embedded Mongo启动端口的问题？ #

根因分析 #

出现端口配置失效的问题，本质是两类配置逻辑的冲突：

• Spring Boot自动装配覆盖手动实例
  项目引入嵌入式Mongo starter依赖后，Spring Boot会默认启动一套独立的嵌入式Mongo流程，这套流程默认使用随机可用端口完成实例启动。由于自动装配的加载优先级高于你在测试方法中手动启动的实例，最终容器内注入的Mongo连接、测试日志显示的连接目标，都是自动装配生成的随机端口实例，手动启动的实例实际上成了未被使用的冗余进程。
• 全局启动单例的端口fallback策略
  你通过MongodStarter.getDefaultInstance()获取的全局单例启动器，在部分版本中会对传入的固定端口做可用性校验：如果校验过程中识别到端口权限不足、IPv6/IPv4栈匹配偏差、临时端口被系统预占用，就会自动跳过传入的固定端口，fallback到随机端口分配逻辑，且不会抛出明确的配置异常。

修复操作步骤 #

• 关闭自动装配的冲突来源
  在测试类的@SpringBootTest注解中排除嵌入式Mongo相关的自动配置类，避免自动流程旁路你的手动启动逻辑：

  @SpringBootTest(
      classes = Application.class,
      exclude = {MongoAutoConfiguration.class, EmbeddedMongoAutoConfiguration.class}
  )
  

• 优化端口与网络配置
  你当前使用的65000属于系统临时端口段，很容易被其他进程预占触发fallback逻辑，建议替换为常规测试端口，同时关闭自动IPv6匹配带来的偏差问题：

  // 替换原Net构造逻辑，强制绑定IPv4地址，关闭自动栈匹配
  .net(new Net("127.0.0.1", 27017, false))
  

• 增加启动结果校验
  在mongodExecutable.start()完成后，打印实际绑定的端口信息，直接排查是否存在配置被覆盖的问题：

  mongodExecutable.start();
  System.out.println("手动启动的嵌入式Mongo实际监听端口：" + mongodConfig.net().getPort());
  

• 更简便的替代方案
  如果不需要完全手动管理嵌入式Mongo实例，可以直接通过配置文件接管自动装配的端口策略，避免手动编码带来的冲突：在测试环境配置文件中添加固定端口配置即可，不需要手动编写启动代码。

内容的提问来源于stack exchange，提问作者ng.newbie