Tomcat8部署Spring应用报错：无法自动装配org.hibernate.SessionFactory

我有一个基于JdbcTemplate开发的应用，但其中两个类采用了Hibernate配置。这个应用在Tomcat7服务器上部署后运行完全正常，但部署到同一服务器的Tomcat8时，抛出了如下异常：

org.springframework.beans.factory.BeanCreationException: Could not autowire field: private org.hibernate.SessionFactory

相关servlet.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: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/context
           http://www.springframework.org/schema/context/spring-context.xsd">
    <!-- 你的SessionFactory相关配置 -->
</beans>

可能的原因及解决方案 #

我帮你梳理几个Tomcat7到Tomcat8迁移时最常见的排查方向，都是实际项目里容易踩的坑：

• Tomcat类加载机制调整：Tomcat8对类加载器的优先级做了改动，尤其是JPA/Hibernate相关类的加载逻辑。Tomcat7中你的WEB-INF/lib下的Hibernate jar包能被正常加载，但Tomcat8可能会优先使用系统类加载器加载自带的JPA API，导致和应用内的Hibernate类冲突。

  • 解决办法：在应用的META-INF/context.xml中添加<Loader delegate="true"/>，让web应用的类加载器优先加载自己的jar包；另外检查WEB-INF/lib下的Hibernate版本，确保和Tomcat8兼容（比如Hibernate 4.3+适配Tomcat8）。

• Spring与Hibernate版本不兼容：如果你的Spring版本偏旧（比如Spring 3.x），它和Tomcat8的环境适配性会很差，尤其是SessionFactory的自动注入逻辑可能存在bug。

  • 解决办法：升级Spring到4.2及以上版本（Tomcat8推荐搭配Spring 4.x+），同时保证Hibernate版本和Spring匹配——比如Spring 4.3+搭配Hibernate 5.x，Spring 4.2搭配Hibernate 4.3.x。

• SessionFactory配置细节问题：虽然Tomcat7能正常运行，但Tomcat8对配置的校验更严格，可能你的配置存在隐性问题。

  • 检查点：确认sessionFactory bean的dataSource引用正确、packagesToScan指定了正确的实体类路径、Hibernate属性（比如dialect）配置无误；另外要确保需要注入SessionFactory的类添加了@Repository/@Component注解，并且被Spring的组件扫描覆盖到。
  • 参考正确的配置示例：

    <bean id="sessionFactory" class="org.springframework.orm.hibernate5.LocalSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="packagesToScan" value="com.yourapp.entity"/>
        <property name="hibernateProperties">
            <props>
                <prop key="hibernate.dialect">org.hibernate.dialect.MySQL57Dialect</prop>
                <prop key="hibernate.show_sql">true</prop>
                <prop key="hibernate.hbm2ddl.auto">update</prop>
            </props>
        </property>
    </bean>
    

• JDBC驱动兼容性问题：旧版JDBC驱动可能在Tomcat8的连接池环境下无法正常工作，间接导致SessionFactory初始化失败。

  • 解决办法：升级JDBC驱动到适配Tomcat8的版本，比如MySQL驱动用5.1.47或8.0.x系列，Oracle驱动用12c及以上版本。

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