此版本仍在开发中，尚未稳定。如需最新的稳定版本，请使用 Spring Framework 7.0.6！spring-doc.cadn.net.cn

使用 `@Autowired`

JSR 330 的 @Inject 注解可以用于替代本节示例中的 Spring 的 @Autowired 注解。有关更多详细信息，请参见这里。spring-doc.cadn.net.cn

您可以将 @Autowired 注解应用于构造函数，如下例所示：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	private final CustomerPreferenceDao customerPreferenceDao;

	@Autowired
	public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
		this.customerPreferenceDao = customerPreferenceDao;
	}

	// ...
}

class MovieRecommender @Autowired constructor(
	private val customerPreferenceDao: CustomerPreferenceDao)

在一个目标bean仅定义了一个构造器的情况下，该构造器上的@0注解是不必要的。但是，如果存在多个构造器且没有主要或默认构造器，那么至少需要其中一个构造器被@1注解，以便指导容器使用哪一个。详细信息请参见构造器解析的讨论部分。spring-doc.cadn.net.cn

您可以将@Autowired注解应用于传统的setter方法，如下例所示:spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class SimpleMovieLister {

	private MovieFinder movieFinder;

	@Autowired
	public void setMovieFinder(MovieFinder movieFinder) {
		this.movieFinder = movieFinder;
	}

	// ...
}

class SimpleMovieLister {

	@set:Autowired
	lateinit var movieFinder: MovieFinder

	// ...

}

您可以将@Autowired应用于具有任意名称和多个参数的方法，如下例所示:spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	private MovieCatalog movieCatalog;

	private CustomerPreferenceDao customerPreferenceDao;

	@Autowired
	public void prepare(MovieCatalog movieCatalog,
			CustomerPreferenceDao customerPreferenceDao) {
		this.movieCatalog = movieCatalog;
		this.customerPreferenceDao = customerPreferenceDao;
	}

	// ...
}

class MovieRecommender {

	private lateinit var movieCatalog: MovieCatalog

	private lateinit var customerPreferenceDao: CustomerPreferenceDao

	@Autowired
	fun prepare(movieCatalog: MovieCatalog,
				customerPreferenceDao: CustomerPreferenceDao) {
		this.movieCatalog = movieCatalog
		this.customerPreferenceDao = customerPreferenceDao
	}

	// ...
}

您可以将 @Autowired 应用于字段，甚至可以将其与构造函数结合使用，如下例所示：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	private final CustomerPreferenceDao customerPreferenceDao;

	@Autowired
	private MovieCatalog movieCatalog;

	@Autowired
	public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
		this.customerPreferenceDao = customerPreferenceDao;
	}

	// ...
}

class MovieRecommender @Autowired constructor(
	private val customerPreferenceDao: CustomerPreferenceDao) {

	@Autowired
	private lateinit var movieCatalog: MovieCatalog

	// ...
}

确保您的目标组件（例如，MovieCatalog 或 CustomerPreferenceDao）通过您用于 @Autowired 注解的注入点的类型进行一致声明。否则，可能会由于运行时出现“未找到类型匹配”错误而导致注入失败。spring-doc.cadn.net.cn

对于通过XML定义的bean或通过类路径扫描找到的组件类，容器通常提前知道具体的类型。然而，对于使用工厂方法的情况，你需要确保声明的返回类型具有足够的表现力。对于实现了多个接口的组件，或是可能通过其实现类型被引用的组件，应在你的工厂方法上声明最具体的返回类型（至少要与引用你的bean的注入点所要求的类型一样具体）。spring-doc.cadn.net.cn

自身注入

@Autowired 在注入时也会考虑自引用（即指向当前正在被注入的 Bean 的引用）。spring-doc.cadn.net.cn

但请注意，自我注入是一种回退机制。对其他组件的常规依赖始终具有优先权。因此，自我引用不参与常规的自动装配候选者选择，尤其永远不会成为首选（primary）。相反，它们的优先级总是最低的。spring-doc.cadn.net.cn

在实践中，你应该仅将自引用作为最后的手段——例如，通过 bean 的事务代理调用同一实例上的其他方法。作为替代方案，在这种情况下，可以考虑将受影响的方法提取到一个独立的委托 bean 中。spring-doc.cadn.net.cn

另一种选择是使用 @Resource，它可以通过当前 bean 的唯一名称获取一个指向该 bean 的代理。spring-doc.cadn.net.cn

尝试将来自同一个 @Bean 类中的 @Configuration 方法的结果注入时，实际上也会形成一种自引用场景。可以在实际需要的地方（而不是配置类中的自动装配字段）通过方法签名惰性解析此类引用，或者将受影响的 @Bean 方法声明为 static，从而使其与包含该方法的配置类实例及其生命周期解耦。否则，这些 bean 仅在回退阶段被考虑，而其他配置类中匹配的 bean 将被选为主要候选对象（如果存在的话）。spring-doc.cadn.net.cn

您还可以通过将 @Autowired 注解添加到期望该类型数组的字段或方法上来指示 Spring 从 ApplicationContext 提供该类型的全部 beans，如下例所示：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	@Autowired
	private MovieCatalog[] movieCatalogs;

	// ...
}

class MovieRecommender {

	@Autowired
	private lateinit var movieCatalogs: Array<MovieCatalog>

	// ...
}

类型集合也适用此规则，如下例所示：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	private Set<MovieCatalog> movieCatalogs;

	@Autowired
	public void setMovieCatalogs(Set<MovieCatalog> movieCatalogs) {
		this.movieCatalogs = movieCatalogs;
	}

	// ...
}

class MovieRecommender {

	@Autowired
	lateinit var movieCatalogs: Set<MovieCatalog>

	// ...
}

您的目标Bean可以实现org.springframework.core.Ordered接口，或者如果希望数组或列表中的项按特定顺序排序，可以使用@Order或标准的@Priority注解。否则，它们的顺序将遵循容器中相应目标Bean定义的注册顺序。spring-doc.cadn.net.cn

您可以将 @Order 注解声明在目标类级别和 @Bean 方法上，可能用于单独的 bean 定义（当多个定义使用相同的 bean 类时）。 @Order 值可能会影响注入点的优先级，但请注意，它们不会影响单例的启动顺序，这是一个由依赖关系和 @DependsOn 声明决定的独立问题。spring-doc.cadn.net.cn

请注意，配置类上的 @Order 注解仅影响启动时所有配置类集合中的评估顺序。此类配置级别的顺序值完全不影响其中包含的 @Bean 方法。对于 Bean 级别的排序，每个 @Bean 方法都需要有自己的 @Order 注解，该注解适用于针对特定 Bean 类型（由工厂方法返回）的多个匹配项集合。spring-doc.cadn.net.cn

请注意，标准的 jakarta.annotation.Priority 注解在 @Bean 级别不可用，因为它不能在方法上声明。可以通过为每种类型的单个 Bean 使用 @Order 值结合 @Primary 或 @Fallback 来模拟其语义。spring-doc.cadn.net.cn

即使已键入的Map个实例，只要期望的键类型为String，也可以进行自动装配。映射值都是预期类型的bean，键则是相应的bean名称，如下例所示:spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	private Map<String, MovieCatalog> movieCatalogs;

	@Autowired
	public void setMovieCatalogs(Map<String, MovieCatalog> movieCatalogs) {
		this.movieCatalogs = movieCatalogs;
	}

	// ...
}

class MovieRecommender {

	@Autowired
	lateinit var movieCatalogs: Map<String, MovieCatalog>

	// ...
}

默认情况下，当没有可用的匹配候选 Bean 时，自动装配会失败。在声明了数组、集合或映射的情况下，至少需要一个匹配的元素。spring-doc.cadn.net.cn

默认行为是将带注解的方法和字段视为指示必需的依赖项。您可以按照以下示例中的方法更改此行为，使框架通过将其标记为非必需来跳过无法满足的注入点（即，通过将 required 属性设置为 @Autowired 为 false）：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class SimpleMovieLister {

	private MovieFinder movieFinder;

	@Autowired(required = false)
	public void setMovieFinder(MovieFinder movieFinder) {
		this.movieFinder = movieFinder;
	}

	// ...
}

class SimpleMovieLister {

	@Autowired(required = false)
	var movieFinder: MovieFinder? = null

	// ...
}

如果其依赖项（或在多个参数的情况下，其中一个依赖项）不可用，则不会调用非必需方法。在这种情况下，非必需字段将不会被填充，保留其默认值。spring-doc.cadn.net.cn

换句话说，将 required 属性设置为 false 表示该属性在自动连线时是可选的，如果无法自动连线，则该属性将被忽略。这允许属性被赋予默认值，这些值可以通过依赖注入进行可选的覆盖。spring-doc.cadn.net.cn

注入的构造函数和工厂方法参数是一个特殊情况，因为 required 属性在 @Autowired 中由于 Spring 的构造函数解析算法可能涉及多个构造函数，因此含义略有不同。构造函数和工厂方法参数默认是必需的，但在单个构造函数的情况下有一些特殊规则，例如多元素注入点（数组、集合、映射）如果没有匹配的 bean 可用，会解析为空实例。这允许一种常见的实现模式，即所有依赖项都可以在唯一的多参数构造函数中声明——例如，声明为一个没有 @Autowired 注解的公共构造函数。spring-doc.cadn.net.cn

任何给定的bean类只能有一个构造函数声明@Autowired，并且将required属性设置为true，这表示在用作Spring bean时要自动注入的构造函数。因此，如果required属性保持其默认值true，则只能有一个构造函数使用@Autowired进行注解。如果多个构造函数声明了该注解，则它们都必须声明required=false，以便作为自动注入的候选（类似于XML中的autowire=constructor）。具有最多可由Spring容器中的匹配bean满足的依赖项的构造函数将被选择。如果没有任何候选构造函数可以满足，则将使用主/默认构造函数（如果存在的话）。同样，如果一个类声明了多个构造函数但没有一个使用@Autowired进行注解，则将使用主/默认构造函数（如果存在的话）。如果一个类只声明了一个构造函数，则无论是否进行注解都会使用它。请注意，带注解的构造函数不一定是公共的。spring-doc.cadn.net.cn

另外，您也可以通过Java的java.util.Optional来表达某个依赖关系的非必需性，如下例所示:spring-doc.cadn.net.cn

public class SimpleMovieLister {

	@Autowired
	public void setMovieFinder(Optional<MovieFinder> movieFinder) {
		...
	}
}

您也可以使用参数级别的 @Nullable 注解（任何种类，来自任何包 — 例如，JSpecify 提供的 org.jspecify.annotations.Nullable）或直接利用 Kotlin 内置的空安全支持:spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class SimpleMovieLister {

	@Autowired
	public void setMovieFinder(@Nullable MovieFinder movieFinder) {
		...
	}
}

class SimpleMovieLister {

	@Autowired
	var movieFinder: MovieFinder? = null

	// ...
}

您也可以使用 @Autowired 来表示那些已知的可解析依赖接口： BeanFactory、ApplicationContext、Environment、ResourceLoader、 ApplicationEventPublisher 和 MessageSource。这些接口及其扩展接口，例如 ConfigurableApplicationContext 或 ResourcePatternResolver，会自动被解析，无需特殊配置。下面的示例演示了如何自动注入一个 ApplicationContext 对象：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
Kotlinspring-doc.cadn.net.cn

public class MovieRecommender {

	@Autowired
	private ApplicationContext context;

	public MovieRecommender() {
	}

	// ...
}

class MovieRecommender {

	@Autowired
	lateinit var context: ApplicationContext

	// ...
}

数字 @Autowired, @Inject, @Value, 和 @Resource 的注解由 Spring BeanPostProcessor 实现处理。这意味着您不能在自己的 BeanPostProcessor 或 BeanFactoryPostProcessor 类型（如果有的话）中应用这些注解。spring-doc.cadn.net.cn

这些类型必须通过使用XML或Spring 配置方法明确地'连接'起来。spring-doc.cadn.net.cn

使用 @Autowired

使用 `@Autowired`