@Resource 详解：JSR-规范中的依赖注入注解

一、概述

@Resource 是 Java JSR‑250 规范中定义的注解，用于声明依赖注入。Spring 容器支持 @Resource将其作为依赖注入的一种方式。

import javax.annotation.Resource;@Service
public class UserService {
@Resource
private UserMapper userMapper;}

它的全限定名是 javax.annotation.Resource或 jakarta.annotation.Resource属于 Java 标准库，而非 Spring 专有。Spring 通过 CommonAnnotationBeanPostProcessor 处理该注解。

二、@Resource 的装配逻辑

@Resource 遵循以下装配规则：

1. 如果没有指定 name 属性，默认使用字段名作为 Bean 名称进行按名称查找。
2. 若按名称未找到匹配的 Bean，则按类型查找。
3. 如果显式指定了 name 属性。则仅按名称查找，不会再按类型匹配。

// 字段名为 userMapper，先按名称 "userMapper" 查找
@Resource
private UserMapper userMapper;

@Resource 默认按名称装配，这与 @Autowired有本质区别。

• @Primary 不被支持：@Resource 不会考虑 @Primary 注解。若容器中存在多个同类型 Bean 且未指定 name，将抛出异常。
• @Required=false 无效：@Resource 没有类似 required=false 的语义。必须成功注入，否则抛出异常。怎么说呢，
• @Resource 只能用于字段或 setter 方法。不能用于构造器或方法参数注入。

三、基本用法

按名称注入

@Component
public class UserDao { }
@Service
public class UserService {
// 通过 name 属性指定 Bean 名称
@Resource
private UserDao userDao;}

按字段名注入

@Component
public class UserMapper { }
@Service
public class UserService {
// 字段名 "userMapper" 作为 Bean 名称
@Resource
private UserMapper userMapper;}

按类型注入

@Service
public class CustomUserService {
// 若容器中只有一个 UserMapper 类型的 Bean，按类型注入
@Resource
private UserMapper customMapper;}

注入集合类型

@Service
public class PaymentService {
// 注入所有 PaymentProcessor 类型的 Bean
@Resource
private List processors;}

四、@Resource 与 @Autowired 的区别对比表格

对比维度	@Resource	@Autowired
来源	JSR‑250	Spring 框架专有装配顺序：默认按类型→可选优先级/qualifier 等规则处理。
装配顺序	先按 name 再按 type；若 name 指定则只用 name。	先按 type 再可选 qualifier 或 primary；可通过 required=false 控制可选性。
required=>false 支持	不支持，需要手动捕获异常或使用 Optional 等包装类。	直接支持，可省略 required=true 并允许空值。话说回来，
@Primary 支持	不支持；若出现多重同型 Bean 则报错。	完全支持，可通过 @Primary 或 @Qualifier 配合使用。

构造器/方法参数 注入 

✓ 

五、使用场景与选择建议

• 需要精确控制 bean 名称时： • 使用 @ Resource 比 @Autowired + @Qualifier 更简洁；• 在多模块项目里避免因同类多实例导致混乱。

保持对 Java 标准的兼容性： • 减少对 Spring 框架特性的耦合，在非 Spring 容器下保持通用性。

JNDI 或外部资源访问： • 使用 lookup 属性直接获取外部资源，无需额外配置。

仅需单一实现且无特殊需求： • 如果项目全部基于 Spring Boot。而且没有跨容器迁移需求，推荐使用 @Autowired其功能更丰富且更易维护。

需要 optional / primary 等高级特性： • 当出现多实现且想要优先级排序时用 @Autowired + @Qualifier + @Primary;@Resource 无法满足此场景。话说回来，

六、常见问题汇总

- 出现多个匹配的 Bean当字段名无法对应唯一 bean 时会抛出 NoSuchBeanDefinitionException。java @Component public class AliPayService implements PaymentService { }

@Component public class WechatPayService implements PaymentService { }

@Service public class OrderService { // 字段名 "paymentService" 无法匹配到具体 Bean，抛出异常 @Resource private PaymentService paymentService;} `` 至于解决方式，显式指定name或采用@Qualifier与@Primary合作。- **混用 @Resource 与 @Autowired**：两者语义不同，如required=false与primary等差异可能导致难以排查的问题。建议同一类内保持一致，不过，- **静态字段注入**：@Resource无法直接注入静态成员。可通过构造函数赋值或手动赋值。- **缺少required=false支持**：如果某个依赖是可选的，需要改为Optional` 或手动捕获异常来处理。老实说，- 构造器/方法参数未被支持虽然新版 Spring 已经支持。但旧版本仍然无法正常工作，请确认框架版本。

七、Spring Boot 中的实际使用示例

- 注入 Service / Mapper 等业务组件：常见于 MyBatis-SpringBoot 项目中。- 配置绑定 Bean 的自动化填充。- 极少数情况下从 JNDI 获取数据库连接等资源，例如在公司内部部署时。

八、与常用方法

---