Spring 5迁移后@Resource依赖注入报错NoSuchBeanDefinitionException

我之前从Spring 4升级到Spring 5时也碰到过一模一样的问题，结合你的报错信息和环境配置，咱们来逐个排查可能的原因：

1. 缺失JSR-250 API依赖（最常见的坑） #

Spring 5开始不再默认包含@Resource注解所属的JSR-250规范API jar包，而Spring 4版本中可能通过间接依赖自动引入了。如果你的类路径里没有javax.annotation-api，Spring就无法识别并处理@Resource注解，直接导致找不到对应bean。

解决方法：在你的依赖管理工具中添加这个依赖，比如Maven：

<dependency>
    <groupId>javax.annotation</groupId>
    <artifactId>javax.annotation-api</artifactId>
    <version>1.3.2</version>
</dependency>

Gradle的话：

implementation 'javax.annotation:javax.annotation-api:1.3.2'

2. @Resource匹配规则的细微变化 #

Spring 5对@Resource的匹配逻辑做了调整：

• 当你没有给@Resource指定name属性时，Spring会优先按字段/方法名作为bean名称去匹配；
• 如果找不到同名bean，Spring 4会自动fallback到按类型匹配，但Spring 5中如果存在多个同类型bean，这个fallback会直接失效，抛出NoSuchBeanDefinitionException。

解决方法：

• 明确指定@Resource的name属性，比如@Resource(name = "userServiceImpl")，确保和目标bean的名称完全一致；
• 如果想按类型注入，改用@Autowired配合@Qualifier（比如@Autowired @Qualifier("userServiceImpl")），或者给目标bean标注@Primary（当同类型有多个bean时，优先注入这个）。

3. 组件扫描配置不完整 #

检查你的Spring配置是否正确扫描到了目标bean所在的包：

• 如果是注解驱动配置，确认@ComponentScan的basePackages属性包含了目标bean的包路径，比如@ComponentScan(basePackages = "com.yourpackage.service")；
• 如果是XML配置，确认<context:component-scan>的base-package设置正确；
• 同时要确保目标bean上标注了@Component、@Service、@Repository这类 stereotype注解，或者在配置类中用@Bean定义了该bean。

4. Bean名称的大小写问题 #

Spring生成bean名称的规则是：类名首字母小写（比如UserService对应的bean名称是userService），但如果类名的前两个字母都是大写（比如UService），bean名称会保留原类名。

你可以检查@Resource引用的名称是否和实际容器中的bean名称一致，最简单的方法是打印容器中所有bean的信息：

@Autowired
private ApplicationContext context;

@PostConstruct
public void listAllBeans() {
    String[] beanNames = context.getBeanDefinitionNames();
    for (String beanName : beanNames) {
        System.out.println("Bean名称：" + beanName + "，类型：" + context.getBean(beanName).getClass().getName());
    }
}

运行后就能确认目标bean是否真的被注册到容器中了。

内容的提问来源于stack exchange，提问作者Chandan Ghosh