Spring中@Qualifier与@Primary注解用途及多实现类注入疑问

一、为什么要定义同一接口的多个实现？ #

同一接口的多个实现本质是为了适配不同业务场景或环境需求，举几个实际场景：

• 环境差异：开发环境用Laptop模拟轻便测试设备，生产环境用Desktop模拟高性能服务器设备，通过配置就能切换使用的实现类。
• 业务逻辑分支：比如支付接口有支付宝、微信支付两种实现，不同业务模块可以按需注入对应的实现。
• 扩展性：后续新增Tablet这类新实现时，无需修改原有依赖注入的代码，只需添加新实现类并配置即可。

你的代码里Laptop和Desktop都是Spring容器管理的有效Bean，@Primary只是标记了默认注入的实现，不代表其他实现无法被使用。

二、如何注入@Primary之外的其他实现？ #

完全可以注入其他实现，主要有两种常用方式：

1. 使用@Qualifier注解指定Bean名称 #

Spring默认会把类名首字母小写作为Bean名称（比如Desktop类的Bean名称是desktop），结合@Qualifier就能精准指定要注入的实现：

@RestController
public class ComputerController {
    private final Computer pc;

    // 构造注入时通过@Qualifier指定要注入Desktop
    public ComputerController(@Qualifier("desktop") Computer pc) {
        this.pc = pc;
    }

    @GetMapping("/")
    public String someMethod() {
        return pc.name();
    }
}

你也可以给实现类自定义Bean名称，比如给Desktop添加@Component("myDesktop")，之后用@Qualifier("myDesktop")就能匹配到这个Bean。

2. 直接通过变量名匹配Bean名称 #

如果变量名和Bean名称完全一致，Spring会自动匹配对应的实现，无需额外注解：

@RestController
public class ComputerController {
    // 变量名desktop和Bean名称一致，自动注入Desktop实现
    private final Computer desktop;

    public ComputerController(Computer desktop) {
        this.desktop = desktop;
    }

    @GetMapping("/")
    public String someMethod() {
        return desktop.name();
    }
}

三、@Primary的实际作用 #

@Primary的核心是提供默认注入选项：当多个Bean实现同一接口时，如果没有指定具体要注入的Bean，Spring会优先选择标记了@Primary的实现，避免抛出NoUniqueBeanDefinitionException。它不是限制只能使用这个实现，而是给大多数场景提供一个默认值，少数需要特殊实现的场景再通过@Qualifier指定。

比如你的代码中，如果有10个组件需要注入Computer，其中9个用默认的Laptop，1个用Desktop，给Laptop加@Primary后，9个组件无需额外配置，1个组件用@Qualifier指定Desktop即可，能大幅简化配置。

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