Spring MVC中JpaRepository/StudentDao自动注入失败问题求助

问题描述 #

开发Spring MVC项目时，尝试创建继承JpaRepository的仓库接口出现编译错误，怀疑是JAR包缺失或冲突。改用继承CrudRepository的StudentDao接口后，编写了对应StudentController，并在ApplicationContext.xml中配置了数据源、EntityManagerFactory等组件，引入指定JAR包，但启动项目时抛出BeanCreationException，提示找不到StudentDao的符合条件的Bean实例，无法完成自动注入。

相关代码与配置 #

仓库接口代码 #

public interface StudentDao extends CrudRepository<Student, Long> {
    // methods if any
}

Controller代码 #

package controller;

import dao.StudentDao;
import entity.Student;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

import java.util.List;

@Controller
public class StudentController {

    @Autowired
     StudentDao studentDao;

    @RequestMapping("/student")
    public String studentList(Model model) {
        List<Student> students = (List<Student>) studentDao.findAll();
        model.addAttribute("users", students);
        System.out.println("List of students: " + students);
        System.out.println("Controller of students");
        return "student";
    }
}

ApplicationContext.xml配置 #

<?xml version='1.0' encoding='UTF-8' ?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:p="http://www.springframework.org/schema/p"
       xmlns:aop="http://www.springframework.org/schema/aop"
       xmlns:jpa="http://www.springframework.org/schema/data/jpa"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/aop 
                           http://www.springframework.org/schema/aop/spring-aop.xsd
                           http://www.springframework.org/schema/tx 
                           http://www.springframework.org/schema/tx/spring-tx.xsd
                           http://www.springframework.org/schema/mvc
                           http://www.springframework.org/schema/mvc/spring-mvc.xsd
                           http://www.springframework.org/schema/context
                           http://www.springframework.org/schema/context/spring-context.xsd  
                           http://www.springframework.org/schema/data/jpa 
                           http://www.springframework.org/schema/data/jpa/spring-jpa.xsd">

    <!-- Load properties from application.properties -->
    <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="location" value="/WEB-INF/application.properties" />
    </bean>
 <context:annotation-config />
    <!-- Enable MVC annotations -->
    <mvc:annotation-driven />

    <!-- Serve static resources -->
    <mvc:resources mapping="/reports/**" location="/WEB-INF/reports/" />
    <mvc:resources mapping="/images/**" location="/WEB-INF/images/" />
    <mvc:resources location="/WEB-INF/resources/" mapping="/resources/**"/>

    <!-- Enable transaction management -->
    <tx:annotation-driven transaction-manager="jpaTransactionManager"/>

    <!-- Component scan for all relevant packages -->
    <context:component-scan base-package="controller, service, dao, config, dto,entity"/>

    <!-- Configure data source -->
    <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="com.mysql.cj.jdbc.Driver" />
        <property name="url" value="jdbc:mysql://localhost:3306/springdb" />
        <property name="username" value="root" />
        <property name="password" value="root" />
    </bean>

    <!-- Configure JPA EntityManagerFactory -->
    <bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <property name="packagesToScan" value="entity.Student" />
        <property name="jpaVendorAdapter">
            <bean class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter" />
        </property>
        <property name="jpaProperties">
            <props>
                <!-- Set Hibernate dialect -->
                <prop key="hibernate.dialect">org.hibernate.dialect.MySQL5Dialect</prop>
                <!-- Show SQL queries in console for debugging -->
                <prop key="hibernate.show_sql">true</prop>
                <!-- Automatically update database schema -->
                <prop key="hibernate.hbm2ddl.auto">update</prop>
            </props>
        </property>
    </bean>

    <!-- Configure JPA Transaction Manager -->
    <bean id="jpaTransactionManager" class="org.springframework.orm.jpa.JpaTransactionManager">
        <property name="entityManagerFactory" ref="entityManagerFactory" />
    </bean>

</beans>

引入的JAR包列表 #

antlr-2.7.7.jar
aopalliance-1.0.jar
aspectjrt-1.8.0.jar
commons-logging-1.1.3.jar
dom4j-1.6.1.jar
hibernate-commons-annotations-4.0.4.Final.jar
hibernate-core-4.3.5.Final.jar
hibernate-entitymanager-4.3.5.Final.jar
hibernate-jpa-2.1-api-1.0.0.Final.jar
hsqldb-2.3.2.jar
jandex-1.1.0.Final.jar
javassist-3.18.1-GA.jar
javax.servlet-api-3.1.0.jar
javax.servlet.jsp.jstl-1.2.5.jar
jboss-logging-3.1.3.GA.jar
jboss-logging-annotations-1.2.0.Beta1.jar
jboss-transaction-api_1.2_spec-1.0.0.Final.jar
jcl-over-slf4j-1.7.7.jar
jsp-api-2.1.jar
jstl-api-1.2.jar
serializer-2.7.2.jar
servlet-api-2.5.jar
slf4j-api-1.7.7.jar
spring-aop-4.0.7.RELEASE.jar
spring-beans-4.0.7.RELEASE.jar
spring-context-4.0.7.RELEASE.jar
spring-core-4.0.7.RELEASE.jar
spring-data-commons-1.8.0.RELEASE.jar
spring-data-jpa-1.6.0.RELEASE.jar
spring-expression-4.0.7.RELEASE.jar
spring-jdbc-4.0.7.RELEASE.jar
spring-orm-4.0.7.RELEASE.jar
spring-tx-4.0.7.RELEASE.jar
spring-web-4.0.7.RELEASE.jar
spring-webmvc-4.0.7.RELEASE.jar
xalan-2.7.2.jar

控制台错误日志 #

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'studentController': Injection of autowired dependencies failed; nested exception is org.springframework.beans.factory.BeanCreationException: Could not autowire field: dao.StudentDao controller.StudentController.studentDao; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type [dao.StudentDao] found for dependency: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}
        at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor.postProcessPropertyValues(AutowiredAnnotationBeanPostProcessor.java:293)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.populateBean(AbstractAutowireCapableBeanFactory.java:1186)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:537)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:475)

解决步骤 #

1. 添加Spring Data JPA仓库扫描配置 #

配置中已引入jpa命名空间，但缺少<jpa:repositories>标签，Spring Data JPA需要该标签自动生成仓库接口的代理Bean。在ApplicationContext.xml中添加：

<jpa:repositories base-package="dao" />

该标签会扫描dao包下所有继承Spring Data仓库接口的类，自动创建对应的Bean实例。

2. 修正EntityManagerFactory的包扫描路径 #

当前packagesToScan属性值为具体类entity.Student，但该属性需要传入包名，修改为：

<property name="packagesToScan" value="entity" />

确保能扫描到entity包下所有实体类。

3. 清理冲突的JAR包 #

同时引入了servlet-api-2.5.jar和javax.servlet-api-3.1.0.jar，存在版本冲突。保留javax.servlet-api-3.1.0.jar，删除servlet-api-2.5.jar和jsp-api-2.1.jar。

4. 可选：给仓库接口添加@Repository注解 #

给StudentDao添加@Repository注解，明确标记为仓库Bean，增强代码可读性：

import org.springframework.data.repository.CrudRepository;
import org.springframework.stereotype.Repository;
import entity.Student;

@Repository
public interface StudentDao extends CrudRepository<Student, Long> {
    // methods if any
}

完成以上修改后，重新启动项目即可解决Bean找不到的问题。

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