@TestConfiguration模拟对象被Spring Boot实际应用错误加载问题

可能的原因 #

• 构建工具配置出错：Maven/Gradle不小心把src/test/java下的类编译并打包到了主应用的classpath里，导致Spring启动时能找到这些测试配置类。比如Maven的<sourceDirectory>误设成test目录，或是Gradle的sourceSets配置混乱。
• @Import写法错误：你用了@Import(value = "MockApplicationServiceConfiguration.class")这种字符串包裹的写法，这是错误的——正确的应该直接传入类对象MockApplicationServiceConfiguration.class。这种错误写法可能让Spring解析时出现异常逻辑，一旦测试类被意外纳入主classpath，就会被加载。
• 组件扫描范围过大：主应用的@SpringBootApplication扫描范围不小心覆盖了test目录的包，比如测试类放在了主应用扫描的根包下，导致Spring扫到了@TestConfiguration类。不过正常情况下@TestConfiguration不会被主应用自动扫描，除非被显式导入。

解决步骤 #

1. 检查构建工具配置

   • Maven：打开pom.xml，确认<build>块里的<sourceDirectory>是src/main/java，<testSourceDirectory>是src/test/java，且主打包任务（package）不会把test目录的类放进主jar。可以去target/classes目录下查看有没有测试类，要是有，说明配置存在问题。
   • Gradle：检查build.gradle里的sourceSets配置，确保main.java.srcDirs = ['src/main/java']，test.java.srcDirs = ['src/test/java']，运行gradle clean build后，主jar里不该包含test类。

2. 修正@Import的写法
   把测试类里的导入语句改成正确形式：

   @SpringBootTest
   @Import(MockApplicationServiceConfiguration.class)
   

   去掉字符串包裹，直接传入类对象，这才是@Import的标准用法。

3. 确认测试类的位置与扫描范围
   保证所有@TestConfiguration类都放在src/test/java下，且包路径不在主应用的组件扫描范围内。比如主应用扫描com.myapp，测试类就放在com.myapp.test，避免被主应用扫到。

4. 添加Profile防护（可选）
   给测试配置类加上@Profile("test")，这样只有激活test环境时才会加载：

   @TestConfiguration
   @Profile("test")
   public class MockApplicationServiceConfiguration {
       @Bean
       public ApplicationService applicationService() {  
           return new ApplicationService() {
               // mock实现
           };
       }
   }
   

   主应用的配置文件（比如application.properties）里设置spring.profiles.active=prod（或者默认不设置，因为test profile不会自动激活），就算测试类被意外扫到，也不会生效。

内容的提问来源于stack exchange，提问作者gene b.