SpringMVC报错：找不到com.cav.controllers.repository.UserRepository类型合格Bean

问题重现 #

运行SpringMVC应用时抛出以下错误：

No qualifying bean of type 'com.cav.controllers.repository.UserRepository' available: expected at least 1 bean which qualifies as autowire candidate

相关代码片段 #

UserRepository接口

package com.cav.controllers.repository;
import org.springframework.data.jpa.repository.JpaRepository;
import com.cav.models.User;

public interface UserRepository extends JpaRepository<User, String>{}

AddController控制器

@Controller
public class AddController {
    
    @Autowired
    UserRepository userRepository;
    
    @RequestMapping("/addUser")
    public ModelAndView addUser(HttpServletRequest req, HttpServletResponse resp) {
        System.out.println("Running method addUser");
        String param1 = req.getParameter("t1");
        String param2 = req.getParameter("t2");
        String param3 = req.getParameter("t3");
        
        ModelAndView mv = new ModelAndView();
        User user = new User(param1,param2,param3);
        userRepository.save(user);
        mv.setViewName("displayUser.jsp");
        mv.addObject("userID", param1);
        mv.addObject("fname", param2);
        mv.addObject("sname", param3);
        return mv;
    }
}

启动类WebBankMvcApplication

package com.cav;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
public class WebBankMvcApplication {

    public static void main(String[] args) {
        SpringApplication.run(WebBankMvcApplication.class, args);
    }
}

controllers-servlet.xml配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:ctx="http://www.springframework.org/schema/context"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
    http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-2.5.xsd ">
    
    <ctx:annotation-config></ctx:annotation-config>
    <ctx:component-scan base-package="com.cav.controllers"></ctx:component-scan>
</beans>

问题原因 #

1. 未启用Spring Data JPA的Repository扫描：启动类仅导入了@EnableJpaRepositories注解，但未实际标注在类上，导致Spring无法识别UserRepository接口并生成对应的代理Bean。
2. 普通组件扫描无法处理Spring Data JPA Repository：controllers-servlet.xml中的component-scan仅扫描控制器类，无法触发Spring Data JPA对Repository接口的特殊处理。

解决方案 #

1. 在启动类上添加@EnableJpaRepositories注解 #

修改启动类，添加注解开启Repository扫描：

package com.cav;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EnableJpaRepositories // 开启Spring Data JPA Repository扫描，默认扫描启动类所在包及其子包
public class WebBankMvcApplication {

    public static void main(String[] args) {
        SpringApplication.run(WebBankMvcApplication.class, args);
    }
}

如果Repository不在启动类的子包中，可通过basePackages参数指定扫描路径：

@EnableJpaRepositories(basePackages = "com.cav.controllers.repository")

2. 确保User实体类标注@Entity和@Id注解 #

Spring Data JPA需要实体类标注@Entity来识别为JPA实体，同时指定主键字段：

package com.cav.models;

import jakarta.persistence.Entity;
import jakarta.persistence.Id;

@Entity
public class User {
    @Id
    private String id;
    private String fname;
    private String sname;

    // 构造方法、getter和setter方法
    public User(String id, String fname, String sname) {
        this.id = id;
        this.fname = fname;
        this.sname = sname;
    }

    // 无参构造方法（JPA必需）
    public User() {}

    // getter和setter...
}

3. 优化配置（可选） #

由于使用Spring Boot，建议优先使用注解驱动配置，可删除controllers-servlet.xml文件，@SpringBootApplication会自动扫描启动类所在包及其子包下的组件（包括控制器）。

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