Spring创建hibernate4AnnotatedSessionFactory Bean失败问题求助

问题描述 #

启动Spring Web应用时遭遇连锁Bean创建失败，核心错误是找不到org.arpit.java2blog.model.Country类，导致hibernate4AnnotatedSessionFactory的annotatedClasses属性类型转换失败，进而引发多层依赖注入异常。

报错核心堆栈 #

Caused by: org.springframework.beans.factory.BeanCreationException: Could not autowire field: com.programcreek.helloworld.controller.CountryService com.programcreek.helloworld.controller.CountryController.countryService; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'countryService': Injection of autowired dependencies failed; nested exception is org.springframework.beans.factory.BeanCreationException: Could not autowire field: com.programcreek.helloworld.controller.CountryDAO com.programcreek.helloworld.controller.CountryService.countryDao; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'countryDAO': Injection of autowired dependencies failed; nested exception is org.springframework.beans.factory.BeanCreationException: Could not autowire field: private org.hibernate.SessionFactory com.programcreek.helloworld.controller.CountryDAO.sessionFactory; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hibernate4AnnotatedSessionFactory' defined in ServletContext resource [/WEB-INF/dispatcher-servlet.xml]: Initialization of bean failed; nested exception is org.springframework.beans.TypeMismatchException: Failed to convert property value of type 'java.util.ArrayList' to required type 'java.lang.Class[]' for property 'annotatedClasses'; nested exception is java.lang.IllegalArgumentException: Cannot find class [org.arpit.java2blog.model.Country]

相关配置文件 #

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>test</groupId>
  <artifactId>test</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>test Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <properties>
    <spring.version>4.1.6.RELEASE</spring.version>
  </properties>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <!-- Spring dependencies -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-orm</artifactId>
      <version>4.1.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>commons-dbcp</groupId>
      <artifactId>commons-dbcp</artifactId>
      <version>1.4</version>
    </dependency>
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.24</version>
    </dependency>
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>4.0.1.Final</version>
    </dependency>
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-entitymanager</artifactId>
      <version>4.0.1.Final</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>4.0.1.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>test</finalName>
  </build>
</project>

dispatcher-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns="http://www.springframework.org/schema/mvc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:beans="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd">
  <annotation-driven />
  <context:component-scan base-package="com.programcreek.helloworld.controller" />
  <resources mapping="/resources/**" location="/resources/" />
  <beans:bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <beans:property name="prefix" value="/WEB-INF/views/" />
    <beans:property name="suffix" value=".jsp" />
  </beans:bean>
  <beans:bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
    <beans:property name="driverClassName" value="com.mysql.jdbc.Driver" />
    <beans:property name="url" value="jdbc:mysql://localhost:3306/testdb" />
    <beans:property name="username" value="root" />
    <beans:property name="password" value="root" />
  </beans:bean>
  <beans:bean id="hibernate4AnnotatedSessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">
    <beans:property name="dataSource" ref="dataSource" />
    <beans:property name="annotatedClasses">
      <list>
        <value>org.arpit.java2blog.model.Country</value>
      </list>
    </beans:property>
    <beans:property name="hibernateProperties">
      <props>
        <prop key="hibernate.dialect">org.hibernate.dialect.MySQLDialect</prop>
        <prop key="hibernate.show_sql">true</prop>
      </props>
    </beans:property>
  </beans:bean>
  <tx:annotation-driven transaction-manager="transactionManager" />
  <beans:bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager">
    <beans:property name="sessionFactory" ref="hibernate4AnnotatedSessionFactory" />
  </beans:bean>
</beans:beans>

解决方案 #

我来帮你一步步排查解决这个问题：

1. 定位核心问题

从报错最底层的Cannot find class [org.arpit.java2blog.model.Country]可以明确：Spring无法在类路径中找到指定的实体类，这是所有连锁错误的源头。

2. 第一优先级：检查实体类的包路径和存在性

• 先确认你的项目中是否真的存在org.arpit.java2blog.model.Country这个类。从你的Controller、DAO都在com.programcreek.helloworld包下来看，大概率是复制配置时写错了包名，实体类实际应该在com.programcreek.helloworld.model下。
• 如果是包名写错了，直接修改dispatcher-servlet.xml中annotatedClasses的配置：

  <beans:property name="annotatedClasses">
    <list>
      <value>com.programcreek.helloworld.model.Country</value>
    </list>
  </beans:property>
  

3. 第二优先级：确保实体类被正确编译

• 如果你用Maven构建，执行mvn clean compile命令重新编译项目，查看控制台是否有编译错误。如果实体类本身有语法问题（比如缺少@Entity注解、语法错误），会导致编译失败，类不会出现在classpath中。
• 检查target/classes目录下是否有对应的.class文件：target/classes/org/arpit/java2blog/model/Country.class（如果包名正确的话），如果没有，说明编译环节出了问题。

4. 可选优化：统一Spring版本

看你的pom.xml中，spring-tx用的是4.0.1.RELEASE，其他Spring依赖用的是4.1.6.RELEASE，版本不一致可能导致潜在问题，建议把spring-tx的版本也改成${spring.version}：

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-tx</artifactId>
  <version>${spring.version}</version>
</dependency>

5. 可选优化：Hibernate版本适配

Spring 4.1.x和Hibernate 4.3.x的兼容性更好，你可以把Hibernate的版本升级到4.3.11.Final，避免后续可能出现的API不兼容问题：

<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate-core</artifactId>
  <version>4.3.11.Final</version>
</dependency>
<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate-entitymanager</artifactId>
  <version>4.3.11.Final</version>
</dependency>

内容的提问来源于stack exchange，提问作者Explain Down Vote