Spring Boot运行报错：No qualifying bean自动装配候选缺失求助

问题 #

使用Spring Boot 2.7.9（JDK 11）开发应用时，运行阶段抛出No Qualifying bean of type available: expected at least 1 bean which qualifies as autowire candidate.错误。

代码实现 #

public class CatalogServiceImpl extends CatalogService.CatalogServiceImplBase {

    private final DataSourceHandler dataSourceHandlerDelegate;

    private final StorefrontServiceHelper storefrontServiceHelper;

    CatalogServiceImpl(DataSourceHandler dataSourceHandlerDelegate, 
                       StorefrontServiceHelper storefrontServiceHelper) {
        this.dataSourceHandlerDelegate = dataSourceHandlerDelegate;
        this.storefrontServiceHelper = storefrontServiceHelper;
    }
}

public class StorefrontServiceHelper {

    private final CatalogServiceHelper catalogServiceHelper;

    public StorefrontServiceHelper(CatalogServiceHelper catalogServiceHelper) {
        this.catalogServiceHelper = catalogServiceHelper;
    }

}

public class CatalogServiceHelper {

    private final DataSourceHandler dataSourceHandlerDelegate;

    public CatalogServiceHelper(DataSourceHandler dataSourceHandlerDelegate) {
        this.dataSourceHandlerDelegate = dataSourceHandlerDelegate;
    }

}

public interface DataSourceHandler {

}

public class DataSourceHandlerDelegate implements DataSourceHandler {

    private final DataSourceHandler dynamoDBDataSourceHandler;

    public DataSourceHandlerDelegate(DataSourceHandler dynamoDBDataSourceHandler) {
        this.dynamoDBDataSourceHandler = dynamoDBDataSourceHandler;
    }
}

public class AppConfig {

    @Bean
    DataSourceHandlerDelegate dataSourceHandlerDelegate(@Qualifier("DataSourceHandlerDelegate") DataSourceHandler dynamoDBDataSourceHandler) {
        return new DataSourceHandlerDelegate(dynamoDBDataSourceHandler);
    }
}

报错信息 #

2024-10-26 16:20:31,703 [thread="main" class="o.s.b.w.s.c.AnnotationConfigServletWebServerApplicationContext" cid="" id="" dd_trace_id="" dd_span_id=""] Exception encountered during context initialization cancelling refresh attempt: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'catalogServiceImpl' defined in file [item-service/build/classes/java/main/com/item/grpc/CatalogServiceImpl.class]: Unsatisfied dependency expressed through constructor parameter 1; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'storefrontServiceHelper' defined in file [item-service/build/classes/java/main/com/item/service/StorefrontServiceHelper.class]: Unsatisfied dependency expressed through constructor parameter 1; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'catalogServiceHelper' defined in file [item-service/build/classes/java/main/com/item/service/CatalogServiceHelper.class]: Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'dataSourceHandlerDelegate' defined in class path resource [com/item/config/AppConfig.class]: Unsatisfied dependency expressed through method 'dataSourceHandlerDelegate' parameter 0; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.item.datasource.DataSourceHandler' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Qualifier(value="DataSourceHandlerDelegate")}

错误原因分析 #

• 核心Bean缺失：AppConfig中dataSourceHandlerDelegate方法依赖名为DataSourceHandlerDelegate的DataSourceHandler类型Bean，但该Bean未被定义；DataSourceHandlerDelegate构造器需要的dynamoDBDataSourceHandler实例也未注册到Spring容器。
• 服务类未被Spring管理：CatalogServiceImpl、StorefrontServiceHelper、CatalogServiceHelper未添加@Service/@Component等组件注解，Spring无法自动扫描创建实例，导致依赖注入链路中断。
• Bean定义错误引用：@Qualifier("DataSourceHandlerDelegate")指向当前正在定义的Bean名称，形成循环引用，Spring无法解析。
• 代码语法错误：原代码多处变量声明、构造器语句末尾缺失分号，会导致编译失败，间接引发运行时依赖问题。

解决方案 #

1. 注册缺失的DataSourceHandler实现类 #

若dynamoDBDataSourceHandler是DataSourceHandler的实现类，将其注册为Spring Bean：

// 方式1：添加@Component注解（确保类在Spring扫描范围内）
@Component("dynamoDBDataSourceHandler")
public class DynamoDBDataSourceHandlerImpl implements DataSourceHandler {
    // 实现接口方法
}

// 方式2：在AppConfig中定义Bean
@Configuration
public class AppConfig {
    @Bean("dynamoDBDataSourceHandler")
    DataSourceHandler dynamoDBDataSourceHandler() {
        return new DynamoDBDataSourceHandlerImpl();
    }
}

2. 让服务类被Spring扫描管理 #

给所有需要依赖注入的服务类添加@Service注解：

@Service
public class CatalogServiceImpl extends CatalogService.CatalogServiceImplBase {
    // 构造器代码不变
}

@Service
public class StorefrontServiceHelper {
    // 构造器代码不变
}

@Service
public class CatalogServiceHelper {
    // 构造器代码不变
}

3. 修正AppConfig中的Bean定义 #

调整dataSourceHandlerDelegate方法的依赖指向正确的Bean：

@Configuration
public class AppConfig {

    @Bean
    DataSourceHandlerDelegate dataSourceHandlerDelegate(@Qualifier("dynamoDBDataSourceHandler") DataSourceHandler dynamoDBDataSourceHandler) {
        return new DataSourceHandlerDelegate(dynamoDBDataSourceHandler);
    }
}

4. 修复代码语法错误 #

补全原代码中缺失的分号，确保代码正常编译。

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