我之前也碰到过类似的情况，这种问题通常是Starter的配置逻辑在测试环境下没有被正确触发导致的，咱们一步步来排查解决：

1. 确认Starter自动配置的声明是否正确 #

Spring Boot 2.7+版本的Starter需要通过META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件来声明自动配置类（2.7之前用spring.factories）：

• 检查你的Starter模块里是否存在这个文件，且文件内正确填写了自动配置类的全路径，比如：

  com.yourteam.starter.core.MyAutoConfiguration
  

• 可以先在集成测试类里手动添加@Import(MyAutoConfiguration.class)，如果Bean能正常加载，说明自动配置的声明环节出了问题。

2. 排查Bean注册的条件注解限制 #

很多Starter会用@Conditional系列注解控制Bean注册，这些条件在测试环境可能不满足：

• 查看自动配置类里的Bean定义，是否有@ConditionalOnClass(xxx.class)这类注解，而测试环境classpath恰好缺少这个类？
• 如果是属性触发的条件（比如@ConditionalOnProperty(prefix = "my.starter", name = "enabled", havingValue = "true")），检查测试环境的application-test.properties是否配置了对应属性，或者默认值是否不符合预期。

3. 调整@SpringBootTest的扫描范围 #

@SpringBootTest默认扫描测试类所在包及其子包，如果Starter的Bean在外部包下，可能会被遗漏：

• 在测试类上添加@ComponentScan(basePackages = {"com.yourteam.starter", "your.project.base.package"})，明确指定要扫描的包范围；
• 或者直接指定要加载的配置类：@SpringBootTest(classes = {YourProjectApplication.class, MyAutoConfiguration.class})，避免扫描范围的遗漏。

4. 开启调试日志定位Bean注册细节 #

开启Spring的调试日志，能直观看到Bean注册的全流程：

• 在测试环境的配置文件里添加日志配置：

  logging.level.org.springframework.context.annotation=DEBUG
  

• 运行测试后，查看日志里的ConditionEvaluationReport部分，里面会详细记录每个自动配置类、Bean的注册状态，包括被跳过的原因，这能快速锁定问题点。

5. 检查Starter的依赖传递是否正常 #

如果Starter依赖了其他库，而这些库在测试环境没有被正确引入，也会导致Bean无法创建：

• 确认Starter的pom.xml中，核心依赖的scope是compile（而非provided或test），确保测试项目能获取到这些依赖；
• 用mvn dependency:tree（或Gradle的dependencies命令）查看测试项目的依赖树，排查是否有依赖缺失或冲突。

我之前遇到过一次类似问题，就是Starter里的Bean用了@ConditionalOnProperty，但测试环境没配置对应属性，导致Bean没注册，后来在application-test.properties里补上配置就解决了。你按照上面的步骤一步步排查，应该能找到问题根源。

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