@lookup注解用于单例bean中动态获取原型bean,需定义为抽象方法并声明类为abstract,支持按名称或类型查找,不可用于原型bean本身。

@Lookup 注解用于解决单例 Bean 中需要动态获取原型(prototype)Bean 的问题。它不通过属性或构造器注入,而是借助 Spring 在运行时生成子类、重写方法的方式,每次调用被 @Lookup 标注的方法时,都从容器中获取一个全新实例。
必须定义为抽象类或接口中的抽象方法
Spring 只会对抽象方法做代理增强,所以使用 @Lookup 的类必须是 abstract 的,且方法不能有实现体:
- 类需声明为 @Component 或其他组件注解,并加上 abstract 关键字
- 被 @Lookup 标注的方法必须是 public abstract,返回类型即为目标 Bean 类型
- 方法名可自定义(如
getProtoBean()、createUser()),不强制要求 getXXX 形式
支持按名称或类型查找 Bean
@Lookup 注解的 value 属性可指定 Bean 名称,未指定时默认按方法返回类型匹配:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
@Lookup("userServiceImpl")→ 按 bean name 查找 -
@Lookup(无 value)→ 按返回类型查找,要求容器中该类型只有一个 Bean - 若类型有多个 Bean,又没指定 value,启动时会抛出
NoUniqueBeanDefinitionException
不能在原型 Bean 中使用
@Lookup 仅适用于单例作用域的类(默认 scope)。如果目标类本身是 prototype,Spring 会在每次创建实例时尝试重写 @Lookup 方法,但因代理机制依赖单例生命周期管理,容易导致无限递归或代理失效:
- Spring 源码中会检查
beanClass是否为 Java 原生类或非候选类,跳过代理逻辑 - 实际运行中可能报
BeanCreationException或返回 null - 务必确保标注 @Lookup 的类是 singleton(无需显式声明,因为 @Component 默认就是)
替代方案对比(简要)
除了 @Lookup,还有两种常用方式获取新原型实例:
-
ObjectProvider
:轻量、类型安全,推荐用于简单场景,调用 getObject()即可 - @Scope(proxyMode = ScopedProxyMode.TARGET_CLASS):为原型 Bean 创建 CGLIB 代理,使注入点表现为“每次访问都新建”,适合复杂依赖链
- @Lookup 更适合已有抽象结构、或需封装获取逻辑的场景,但侵入性强(必须改类为 abstract)










