Spring无法注入Service Bean：为何仅特定包路径下可识别？

基础信息 #

• Temporal活动类所在包：com.x.nl.y.customercare.processes.activity.subscription
• 活动类代码：

@Slf4j
@AllArgsConstructor
@Component
public class ServiceActivitiesImpl implements ServiceActivities {
    private final Service service;

    @Override
    public canBeSavedResponse canBeSaved(CanBeSavedRequest request) {
        return service.canBeSaved(request);
    }
}

• 待注入的Service Bean所在包：com.x.nl.y.customercare.service

问题现象 #

启动时Spring抛出异常：

org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.x.nl.y.customercare.service.Service' 

但将Service类移动到com.x.nl.y.customercare.processes或其子包下后，注入能正常完成。

根因分析 #

核心问题是Spring组件扫描范围未覆盖service包：

• 你的Spring项目（比如Spring Boot）的组件扫描基础包被配置为com.x.nl.y.customercare.processes（或更上层但未包含service分支的包），导致com.x.nl.y.customercare.service下的类没有被Spring扫描并注册为Bean。
• 当Service类移到processes子包时，正好落入扫描范围内，因此能被正常识别并注入。

解决办法 #

1. 扩展组件扫描范围：在Spring启动类（带@SpringBootApplication注解的类）上，修改扫描包配置，包含service包：

// 方式1：指定多个具体包
@SpringBootApplication(scanBasePackages = {"com.x.nl.y.customercare.processes", "com.x.nl.y.customercare.service"})
// 方式2：直接用最上层的父包，一次性覆盖所有子包
// @SpringBootApplication(scanBasePackages = "com.x.nl.y.customercare")
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 确认Service类的注解：确保Service类上标注了@Service（或@Component），否则即使扫描到也不会被注册为Bean。

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