单集成测试类GreenMail运行正常 全量执行时随机启动失败如何解决

问题根因 #

核心是多测试类同时初始化GreenMail实例引发的资源竞争：

• 所有集成测试类都继承BaseIntegration基类，基类中定义的static GreenMailExtension会在每个子类加载时单独初始化，全量执行测试时会同时启动多个GreenMail进程，要么抢占固定3025端口引发冲突，要么随机端口场景下CPU资源被占满导致启动超时
• 即使配置了随机端口，你没有将GreenMail实际绑定的端口同步到Spring上下文，Spring还是会读取配置文件中的固定3025端口，也会引发连接异常

解决方案 #

1. 复用全局单例GreenMail实例 #

避免每个测试类都单独启动GreenMail，将实例抽为全局单例，全程只启动一次服务：

// 单独定义单例持有类
public class GlobalGreenMailConfig {
    private static final ServerSetup SMTP_SETUP = new ServerSetup(0, null, ServerSetup.PROTOCOL_SMTP);
    static {
        // 全量测试资源紧张，可适当拉长超时时间
        SMTP_SETUP.setServerStartupTimeout(15000L);
        SMTP_SETUP.setVerbose(true);
    }

    public static final GreenMailExtension GREEN_MAIL_EXTENSION = new GreenMailExtension(SMTP_SETUP)
            .withConfiguration(GreenMailConfiguration.aConfig().withUser("duke", "springboot"))
            .withPerMethodLifecycle(false);
}

修改BaseIntegration基类的Extension配置，直接引用单例：

@RegisterExtension
protected static GreenMailExtension greenMail = GlobalGreenMailConfig.GREEN_MAIL_EXTENSION;

2. 动态同步GreenMail端口到Spring #

使用随机端口时，配置文件中的固定端口不再生效，需要在基类中通过@DynamicPropertySource将实际端口注入Spring上下文：

@DynamicPropertySource
static void injectMailPort(DynamicPropertyRegistry registry) {
    registry.add("spring.mail.port", () -> greenMail.getSmtp().getPort());
}

删掉application-test.properties中的spring.mail.port配置即可。

3. 可选优化 #

如果仍有偶发超时，可调整测试执行配置关闭测试类并行执行，避免CPU资源抢占，在junit-platform.properties中添加：

junit.jupiter.execution.parallel.enabled = false

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