Spring找不到MyApiDelegate类型bean，配置@ComponentScan也无效如何解决？

问题根因 #

该报错本质是Spring应用上下文中不存在符合要求的MyApiDelegate类型Bean，无法完成控制器的字段注入，你可以按照以下步骤逐一排查解决： #

排查&解决步骤 #

1. 检查@Service注解导入是否正确
   确认MyApiDelegateImpl类上的@Service注解导入的是Spring官方包：

import org.springframework.stereotype.Service;

如果错误导入了其他框架的@Service（如Dubbo、Jakarta.inject的相关注解），Spring不会将该类识别为托管Bean。

2. 修正组件扫描配置
   @SpringBootApplication默认只会扫描启动类所在包（package）及其子包下的组件，如果你自定义了@ComponentScan注解，会覆盖默认的扫描规则，建议直接在@SpringBootApplication中配置扫描路径，无需单独加@ComponentScan：

@SpringBootApplication(scanBasePackages = {"package"})
@Import(SpecificationConf.class)
public class MyApp extends SpringBootServletInitializer {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}

如果有额外需要扫描的第三方包，直接在scanBasePackages数组中追加路径即可。

3. 排除组件扫描过滤规则影响
   检查SpecificationConf配置类、启动类注解中是否配置了@ComponentScan的excludeFilters规则，导致@Service注解的类被过滤，没有注册到Spring上下文。

4. 检查Maven配置问题

• 多模块项目需要确认MyApiDelegateImpl所在模块已经被启动类所在模块正确引入，依赖scope不要设置为provided或test
• 如果使用了Maven Profile，检查对应Profile的编译配置中是否排除了package.rest包下的类，导致target目录下没有生成该类的字节码文件，自然无法被Spring扫描到

5. 调试验证Bean注册状态
   可以在启动类中增加调试代码，直接验证Bean的注册情况：

public static void main(String[] args) {
    ConfigurableApplicationContext ctx = SpringApplication.run(MyApp.class, args);
    // 打印是否存在名为myService的Bean
    System.out.println("Bean是否存在：" + ctx.containsBean("myService"));
    // 打印该Bean是否实现了MyApiDelegate接口
    System.out.println("类型是否匹配：" + (ctx.getBean("myService") instanceof MyApiDelegate));
}

• 若第一行返回false：说明Bean没有被扫描注册，优先排查上述1-3步的配置问题
• 若第一行返回true第二行返回false：说明Bean的类型不匹配，排查MyApiDelegateImpl的接口实现、AOP代理配置问题

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