Spring Boot JUnit测试加载应用上下文失败：单独运行正常但Maven构建失败

咱们先聚焦你遇到的核心矛盾：本地IDE单独运行MailServiceTest一切正常，但执行mvn build -B时却报Spring上下文加载失败。结合你的测试代码来看，大概率是测试类里Spring依赖注入与Mockito手动初始化的冲突，或是Maven构建环境和IDE环境的配置差异导致的，下面给你一步步排查解决：

1. 修复测试类的依赖注入冲突 #

你的测试类里同时做了几件矛盾的事：既让Spring自动注入MailService，又手动new MailService并设置依赖；还用了MockitoAnnotations.initMocks(this)这种偏手动的Mockito初始化方式，在SpringBootTest环境下很容易引发上下文混乱。建议调整成更规范的写法：

优化后的测试类代码 #

// Spring Boot 2.2+推荐用JUnit 5的扩展，兼容Spring和Mockito
@ExtendWith({SpringExtension.class, MockitoExtension.class})
@SpringBootTest(classes = InstaticketapiApplication.class)
public class MailServiceTest {
    @Autowired
    private ApplicationProperties applicationProperties;
    @Autowired
    private MessageSource messageSource;
    @Autowired
    private SpringTemplateEngine springTemplateEngine;
    
    // 用@MockBean替代@Spy，让Spring把这个Mock实例注入到容器中
    @MockBean
    private JavaMailSenderImpl javaMailSender;
    
    @Captor
    private ArgumentCaptor<MimeMessage> messageCaptor;
    
    // 直接让Spring注入MailService，它会自动使用上面的Mock版JavaMailSender
    @Autowired
    private MailService mailService;

    @BeforeEach // JUnit 5用@BeforeEach，JUnit 4保持用@Before即可
    public void setup() {
        // 不需要手动初始化Mockito，MockitoExtension会自动处理
        doNothing().when(javaMailSender).send(any(MimeMessage.class));
    }
    
    // 你的测试方法...
}

为什么这么改？

• @MockBean会让Spring自动替换容器里的真实JavaMailSenderImpl实例，Spring管理的MailService会直接注入这个Mock对象，完全不需要手动创建实例和设置依赖
• 去掉了MockitoAnnotations.initMocks(this)，用MockitoExtension和Spring的扩展协同工作，避免了手动初始化和Spring上下文的冲突
• 彻底消除了"Spring管理实例"和"手动创建实例"的矛盾，这是上下文加载失败的高频诱因

2. 检查Maven构建时的配置文件加载 #

IDE会默认加载src/main/resources和src/test/resources的配置，但Maven构建时可能存在配置差异：

• 确认src/test/resources下的测试配置文件（比如application-test.properties/yml）完整，即使Mock了邮件发送，Spring可能仍会加载邮件相关的配置类，缺失配置会导致上下文初始化失败
• 检查Maven命令是否指定了特定Profile，比如mvn build -B -Ptest，如果测试依赖特定Profile的配置，要确保Profile配置正确

3. 调整Maven Surefire插件配置 #

有时候Surefire插件的版本或配置会导致测试执行异常，比如无法正确识别JUnit版本。可以在pom.xml里指定稳定版的插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.1.2</version> <!-- 用最新稳定版即可 -->
        </plugin>
    </plugins>
</build>

如果你的测试用的是JUnit 5，还需要确保插件支持JUnit 5，可添加JUnit平台依赖：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.1.2</version>
    <dependencies>
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-surefire-provider</artifactId>
            <version>1.9.3</version>
        </dependency>
    </dependencies>
</plugin>

4. 查看Maven构建的详细日志定位问题 #

如果上面的方法都没解决，执行mvn build -B -X（-X开启调试日志），查看完整的上下文加载失败堆栈信息。日志里会明确指出是哪个Bean无法创建、哪个配置项缺失，或是哪个依赖冲突，帮你精准定位问题。

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