Spring集成GreenMail测试报错，寻求排查方案

问题梳理 #

原本Spring应用结合Testcontainers与GraphQL Tester测试完全正常，添加GreenMail用于邮件测试后出现两类异常：

1. 初始报错：ServiceConfigurationError: javax.mail.Provider: com.sun.mail.imap.IMAPProvider not a subtype
2. 添加IMAP配置后出现：VerifyError: Bad return type

一、优先排查依赖冲突 #

这类邮件相关的异常大多源于JavaMail/JakartaMail依赖版本不兼容：

• 执行依赖树命令查看冲突：
  Maven项目运行 mvn dependency:tree，Gradle项目运行 gradle dependencies，重点查找javax.mail、jakarta.mail-api、com.sun.mail:jakarta.mail相关依赖，确保项目中所有邮件类库版本统一。
• 排除冲突依赖：
  如果Spring Boot的spring-boot-starter-mail引入了旧版本JavaMail，在GreenMail依赖中排除冲突模块，示例Maven配置：

  <dependency>
      <groupId>com.icegreen</groupId>
      <artifactId>greenmail-spring</artifactId>
      <version>1.6.15</version>
      <exclusions>
          <exclusion>
              <groupId>com.sun.mail</groupId>
              <artifactId>jakarta.mail</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

二、调整GreenMailExtension配置 #

• 放弃单例注册模式：单例Extension易引发不同测试上下文的类加载器冲突，改为在测试类中通过@RegisterExtension注解声明，或确保单例Extension在每次测试前重置状态。
• 简化初始配置：先仅启用SMTP协议，确认单独工作正常后再逐步添加IMAP。示例配置：

  @RegisterExtension
  static GreenMailExtension greenMail = new GreenMailExtension(ServerSetup.SMTP)
          .withConfiguration(GreenMailConfiguration.aConfig().withUser("test@example.com", "password"));
  

三、处理VerifyError字节码验证错误 #

该错误通常由类版本不兼容导致：

• 检查编译与运行JDK版本一致性：确保项目编译JDK版本和测试运行的JDK版本一致，比如Maven中指定：

  <properties>
      <maven.compiler.source>17</maven.compiler.source>
      <maven.compiler.target>17</maven.compiler.target>
  </properties>
  

• 匹配GreenMail与JDK版本：GreenMail 1.6+支持JDK 8+，若使用JDK 11+，建议升级到GreenMail最新稳定版。

四、测试基类代码检查 #

确保基类配置不会引发上下文污染：

• 避免静态Extension导致的跨测试状态残留，可改为非静态声明或添加重置逻辑。
• 确保测试专用的邮件Bean覆盖生产配置，示例基类代码：

  @SpringBootTest
  @AutoConfigureGraphQlTester
  public abstract class BaseTest {
      @RegisterExtension
      static GreenMailExtension greenMail = new GreenMailExtension(ServerSetup.SMTP)
              .withPort(3025);
  
      @Bean
      @Primary
      public JavaMailSender javaMailSender() {
          JavaMailSenderImpl sender = new JavaMailSenderImpl();
          sender.setHost("localhost");
          sender.setPort(greenMail.getSmtp().getPort());
          sender.setUsername("test");
          sender.setPassword("test");
          return sender;
      }
  }
  

  注意：需确保GreenMail端口与Testcontainers容器端口无冲突。

内容的提问来源于stack exchange，提问作者radek wilo