CouldNotAutowireField——常見spring異常的解決方式

一、原因概述

在開發過程中，可能會遇到CouldNotAutowireField這個異常。究其原因，通常是由於spring無法找到 Bean 來注入。常見的原因包括無法掃描到 Bean、多個 Bean 可以作為注入，但是沒有指定優先級等等。

二、無法掃描到 Bean

導致spring無法注入 Bean 的原因有很多，其中一種比較常見的情況是沒有將 Bean 註冊到 spring 容器中。為了說明這個情況，我們創建一個簡單的類 Student：

public class Student {
    private String name;
    private int age;
    // setters and getters
}

如果我們想要在另一個類中注入 Student，那麼我們就需要在配置類中註冊這個 Bean：

@Configuration
public class AppConfig {
    @Bean
    public Student student() {
        return new Student();
    }
}

對於該類，我們可以將 Bean 的創建過程委託給容器。注意在類上加 @Configuration 註解，表示這是一個配置類。當然還可以使用 @ComponentScan 註解進行自動掃描，自動註冊 Bean。

@Configuration
@ComponentScan(basePackages = {"com.example"})
public class AppConfig {
 
}

以上兩種方法都可以讓 spring 進行掃描，將 Bean 註冊到容器中。

三、多個 Bean 可以作為注入，但沒有指定優先級

在很多情況下，我們可能會遇到同一個類型的多個實現，這時候我們需要指定注入哪一個 Bean。比如在以下的代碼中，Cat 和 Dog 類的實現我們都需要注入，但是spring無法確定注入其中的哪一個。

@Service
public class UserService {
    @Autowired
    private Animal animal;
}
 
@Component
public class Cat implements Animal {
}
 
@Component
public class Dog implements Animal {
}

為了解決該問題，我們需要顯式地告訴spring應該注入哪一個 Bean。有以下兩種方式：

1、使用 @Qualifier 註解指定

@Service
public class UserService {
    @Autowired
    @Qualifier("cat")
    private Animal animal;
}
 
@Component("cat")
public class Cat implements Animal {
}
 
@Component("dog")
public class Dog implements Animal {
}

2、使用 @Primary 註解指定

@Service
public class UserService {
    @Autowired
    private Animal animal;
}
 
@Component
@Primary
public class Cat implements Animal {
}
 
@Component
public class Dog implements Animal {
}

四、注入了一個不存在的 Bean

如果我們在一個類中嘗試注入一個不存在的 Bean，就會拋出 CouldNotAutowireField 的異常，如下所示。

@Service
public class UserService {
    @Autowired
    private Animal animal;
}

如果Animal這個類在容器中不存在，則會拋出異常。

五、總結

CouldNotAutowireField 這個異常很常見，但是一般情況下都能夠通過仔細排查原因得到解決。應該學會從以下幾個方面入手：註冊 Bean、指定注入哪一個 Bean、注入不存在的 Bean。當然，還有其他一些可能導致該異常的原因，這需要根據具體情況具體分析。