Spring Boot UnsatisfiedDependencyException：缺少BlockingQueue类型Bean

问题场景 #

启动Spring Boot应用时，创建路径为C:\Users\guptadee\Projects\Server\Vista\docstash_api_migration\target\classes\com\adp\avs\tax\form\DocStashElasticMigration\Service\Producer.class的producer Bean失败，抛出org.springframework.beans.factory.UnsatisfiedDependencyException异常。根因是该Bean构造方法参数0依赖的java.util.concurrent.BlockingQueue类型Bean未在Spring容器中定义，无符合条件的自动装配候选Bean，导致依赖注入失败。

问题原因 #

Spring的依赖注入机制需要在容器中找到匹配类型的Bean实例，才能完成Producer类的构造和注入。但目前你的项目里既没有将BlockingQueue注册为Spring管理的Bean，也没有在Producer内部直接实例化这个队列，所以Spring无法满足构造方法的依赖需求，进而抛出异常。

解决方案 #

这里提供几种可行的解决方式，你可以根据业务场景灵活选择：

1. 注册BlockingQueue为Spring Bean（推荐用于共享队列场景）

如果你的Producer和后续可能的Consumer需要共享同一个队列实例，建议在配置类中定义BlockingQueue的Bean：

import java.util.concurrent.BlockingQueue;
import java.util.concurrent.LinkedBlockingQueue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class QueueConfiguration {
    @Bean
    public BlockingQueue<YourMessageType> sharedMessageQueue() {
        // 可根据业务需求设置队列容量，比如new LinkedBlockingQueue<>(500)
        return new LinkedBlockingQueue<>();
    }
}

• 注意替换YourMessageType为你实际使用的消息类型（比如业务实体类或String）；
• 定义完成后，Spring会自动将这个队列实例注入到Producer的构造方法中。

2. 在Producer内部直接实例化队列（适用于队列仅当前类使用）

如果这个队列只需要被Producer自己使用，不需要和其他组件共享，可以直接在构造方法里创建实例：

import java.util.concurrent.BlockingQueue;
import java.util.concurrent.LinkedBlockingQueue;
import org.springframework.stereotype.Service;

@Service
public class Producer {
    private final BlockingQueue<YourMessageType> queue;

    public Producer() {
        // 直接初始化队列
        this.queue = new LinkedBlockingQueue<>();
    }

    // 你的业务方法，比如sendMessage等
}

这种方式不需要Spring管理队列，简单直接，适合单一组件使用队列的场景。

3. 多队列场景下指定注入的Bean

如果项目中存在多个BlockingQueue类型的Bean，需要在Producer的构造方法参数上通过@Qualifier指定具体要注入的Bean名称：

import java.util.concurrent.BlockingQueue;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Service;

@Service
public class Producer {
    private final BlockingQueue<YourMessageType> queue;

    public Producer(@Qualifier("sharedMessageQueue") BlockingQueue<YourMessageType> queue) {
        this.queue = queue;
    }
}

这里的sharedMessageQueue要和你在配置类中定义的Bean方法名一致（也就是Bean的名称）。

小提示 #

如果是实现生产者消费者模式，优先选择第一种方案，这样生产者和消费者可以共享同一个队列实例，保证消息能正常传递；如果只是单一组件使用队列，第二种方案更简洁。

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