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

更新時(shí)間：2025年06月06日 09:10:10 作者：長(zhǎng)勺

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

核心作用：

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

使用示例：

場(chǎng)景定義

假設(shè)有一個(gè)支付接口 PaymentService 和兩個(gè)實(shí)現(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 會(huì)報(bào)錯(cuò)：

@Autowired
private PaymentService paymentService; // 拋出 NoUniqueBeanDefinitionException

解決方案：使用 @Primary

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

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

此時(shí)注入會(huì)成功選擇 AlipayService：

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

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

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

常見使用場(chǎng)景：

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

配置方式：

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

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

總結(jié)：

場(chǎng)景	解決方案
多個(gè)同類型 Bean，需默認(rèn)注入一個(gè)	在目標(biāo) Bean 添加 `@Primary`
需要臨時(shí)覆蓋默認(rèn)注入	配合 `@Qualifier` 指定名稱

關(guān)鍵點(diǎn)：@Primary 是 Spring 解決依賴注入歧義性的輕量級(jí)方案，通過隱式指定默認(rèn) Bean 簡(jiǎn)化配置，但在需要精確控制的場(chǎng)景中仍需結(jié)合 @Qualifier 使用。

到此這篇關(guān)于Spring中@Primary注解的作用與使用的文章就介紹到這了,更多相關(guān)Spring @Primary內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: