Spring中@Primary注解的作用與使用

更新時間：2025年06月06日 09:10:10 作者：長勺

本文主要介紹了Spring中@Primary注解的作用與使用,@Primary?注解用于解決依賴注入時的歧義性問題,具有一定的參考價值,感興趣的可以了解一下

核心作用：

解決多個同類型 Bean 的沖突當(dāng)有多個實現(xiàn)同一接口或相同類型的 Bean 時，Spring 無法自動確定注入哪個 Bean，會拋出 NoUniqueBeanDefinitionException。使用 @Primary 可指定默認注入的 Bean。
隱式選擇優(yōu)先級被標(biāo)記為 @Primary 的 Bean 會被優(yōu)先注入，無需額外使用 @Qualifier 指定名稱。

使用示例：

場景定義

假設(shè)有一個支付接口 PaymentService 和兩個實現(xiàn)類：

public interface PaymentService {
    void pay();
}

@Component
public class CreditCardService implements PaymentService {
    @Override
    public void pay() { System.out.println("信用卡支付"); }
}

@Component
public class AlipayService implements PaymentService {
    @Override
    public void pay() { System.out.println("支付寶支付"); }
}

問題：依賴注入歧義

若直接注入 PaymentService，Spring 會報錯：

@Autowired
private PaymentService paymentService; // 拋出 NoUniqueBeanDefinitionException

解決方案：使用 @Primary

標(biāo)記其中一個實現(xiàn)類為默認首選：

@Component
@Primary // 指定為默認注入的 Bean
public class AlipayService implements PaymentService { ... }

此時注入會成功選擇 AlipayService：

@Autowired
private PaymentService paymentService; // 隱式注入 AlipayService

與其他注解的優(yōu)先級：

@Primary vs @Qualifier
- @Qualifier 顯式指定 Bean 名稱的優(yōu)先級高于 @Primary。
- 例如：@Autowired @Qualifier("creditCardService") 會覆蓋 @Primary。
多個 @Primary 的沖突如果多個同類型 Bean 都被標(biāo)記為 @Primary，Spring 會再次拋出歧義異常。

常見使用場景：

數(shù)據(jù)庫多數(shù)據(jù)源配置在多個 DataSource Bean 中，標(biāo)記默認使用的數(shù)據(jù)源。
不同環(huán)境下的實現(xiàn)類例如在測試和生產(chǎn)環(huán)境中提供同一接口的不同實現(xiàn)，通過 @Primary 切換默認實現(xiàn)。
第三方庫的擴展當(dāng)覆蓋第三方庫提供的 Bean 時，將自己的實現(xiàn)標(biāo)記為 @Primary。

配置方式：

除了注解在類上，也可以在 @Bean 方法中使用：

@Configuration
public class AppConfig {
    @Bean
    @Primary // 標(biāo)記此 Bean 為首選
    public PaymentService alipayService() {
        return new AlipayService();
    }
}