Spring MVC+Hibernate项目启动报错：ControllerClassNameHandlerMapping创建失败

环境信息 #

• JDK 1.8
• Spring Framework 4.0.1
• JSTL 1.2.1
• 使用Spring Tool Suite MVC模板开发

错误栈信息 #

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.web.servlet.mvc.support.ControllerClassNameHandlerMapping#0' defined in ServletContext resource [/WEB-INF/dispatcher-servlet.xml]: Initialization of bean failed; 
nested exception is 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: sample.dao.studentDao sample.controller.studentController.stDao; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'studentDao': Injection of autowired dependencies failed; nested exception is org.springframework.beans.factory.BeanCreationException: Could not autowire field: private org.hibernate.SessionFactory sample.dao.studentDao.sessionFactory; nested exception is java.lang.NoClassDefFoundError: [Lorg/hibernate/engine/FilterDefinition;

项目相关文件 #

dispatcher-servlet.xml #

<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:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:aop="http://www.springframework.org/schema/aop"

    xsi:schemaLocation="http://www.springframework.org/schema/beans
                            http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
                            http://www.springframework.org/schema/context
                            http://www.springframework.org/schema/context/spring-context-4.0.xsd
                            http://www.springframework.org/schema/tx
                            http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
                            http://www.springframework.org/schema/mvc
                            http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
                            http://www.springframework.org/schema/aop
                            http://www.springframework.org/schema/aop/spring-aop-4.0.xsd">

    <bean class="org.springframework.web.servlet.mvc.support.ControllerClassNameHandlerMapping"/>

    <!--
    Most controllers will use the ControllerClassNameHandlerMapping above, but
    for the index controller we are using ParameterizableViewController, so we must
    define an explicit mapping for it.
    
    -->
    <context:component-scan base-package="sample"></context:component-scan>
     <mvc:annotation-driven/>
     
   
<bean id="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
        <property name="mappings">
            <props>
                <prop key="index.htm">indexController</prop>
            </props>
        </property>
    </bean>

    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver"
          p:prefix="/WEB-INF/jsp/"
          p:suffix=".jsp" />

    <!--
    The index controller.
    -->
<!--    <bean name="indexController"
          class="org.springframework.web.servlet.mvc.ParameterizableViewController"
          p:viewName="index" />-->
          
          
          
          
<bean class="org.springframework.jdbc.datasource.DriverManagerDataSource" id="dataSource">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/hibernatemvc"/>
<property name="username" value="root"/>
<property name="password" value="mysql"/>
</bean>

 <bean id="sessionFactory"
        class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <property name="packagesToScan" value="sample"></property>
        <property name="hibernateProperties">
            <props>
                <prop key="hibernate.dialect">org.hibernate.dialect.MySQLDialect</prop>
                <prop key="hibernate.show_sql">true</prop>
            </props>
        </property>
    </bean>

    <bean id="hibernateTransactionManager"
        class="org.springframework.orm.hibernate3.HibernateTransactionManager">
        <property name="sessionFactory" ref="sessionFactory" />
    </bean>

</beans>

studentController.java #

package sample.controller;

import com.google.gson.Gson;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import sample.dao.studentDao;
import sample.entity.Details;


/**
 *
 * @author admin
 */

@Controller
public class studentController {
      @Autowired
    studentDao stDao;
     @RequestMapping(value ="index.htm", method = RequestMethod.GET)
    public String index()
    {
        System.out.println("at index");
        return "index";
    }
    
    @RequestMapping(value ="insert.htm", method = RequestMethod.POST)
    public @ResponseBody String insert
        (
            @RequestParam("id") Integer id,
            @RequestParam("name") String name,
            @RequestParam("email") String email,
            @RequestParam("fee") String fee,
              @RequestParam("sname") String sname,
              @RequestParam("contactno") String contactno
        )
  
        {

        Details ei= new Details();
        ei.setName(name);
        ei.setEmail(email);
        ei.setFee(fee);
        ei.setSname(sname);
        ei.setContactno(contactno);
        
        stDao.save(ei);
        
        Gson ob = new Gson();
        return "success";
   }
    
 @RequestMapping(value="fetch.htm", method = RequestMethod.GET)
    public @ResponseBody String display() 
    {
        List<Details> listdetails = (List<Details>) stDao.display();
        return new Gson().toJson(listdetails);
    }

    
    @RequestMapping(value = "delete.htm")
    public @ResponseBody  String delete(@RequestParam("id") Integer id)
    {
        stDao.delete(id);
        return "successful";
    }
    
    @RequestMapping(value = "edit.htm")
    public @ResponseBody  String edit(@RequestParam("id") Integer id)
    {
        List editlist;
        editlist = stDao.getDetailsForEdit(id);
        return new Gson().toJson(editlist);
    }
    
    
    @RequestMapping(value = "update.htm", method = RequestMethod.POST)
    public @ResponseBody String update
        (
            @RequestParam(value="id",required=false) Integer id,
            @RequestParam("name") String name,
            @RequestParam("email") String email,
            @RequestParam("fee") String fee,
            @RequestParam("sname") String sname,
            @RequestParam("contactno") String contactno
       )
        {
            
        Details st = new Details();
        st.setName(name);
        st.setEmail(email);
        st.setFee(fee);
        st.setSname(sname);
        st.setContactno(contactno);
        System.out.println("st");
        stDao.update(st);
        Gson ob = new Gson();
        return "success";
    }

}

studentDao.java #

package sample.dao;

import java.util.List;
import org.hibernate.Criteria;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.criterion.Projections;
import org.hibernate.criterion.Restrictions;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Repository;
import org.springframework.transaction.annotation.Transactional;
import sample.entity.Details;


/**
 *
 * @author admin
 */
@Transactional
@Repository
public class studentDao {

   @Autowired
    private SessionFactory sessionFactory;


    public void save(Details stdinfo) {
        Session session = sessionFactory.openSession();
        session.save(stdinfo);
        session.close();
    }
public List display() {
        Session session = sessionFactory.openSession();
        Criteria criteria = session.createCriteria(Details.class);
        criteria.setProjection(Projections.projectionList().add(Projections.property("id"), "id")
                .add(Projections.property("name"), "name")
                .add(Projections.property("email"), "email")
                .add(Projections.property("fee"), "fee") 
                .add(Projections.property("sname"), "sname") 
                .add(Projections.property("contactno"), "contactno"));
        criteria.setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP);
        List list = criteria.list();
        session.close();
        return list;
    }

    
     public void delete(Integer id){
        Session session = sessionFactory.openSession();
        Transaction trx = session.beginTransaction();
        Details stdtl = new Details(id);
        session.delete(stdtl);
        trx.commit();
        session.close();
    }
  
     
     
     public List getDetailsForEdit(Integer id) {
        Session session = sessionFactory.openSession();
        Criteria criteria = session.createCriteria(Details.class);
        criteria.setProjection(Projections.projectionList()
                .add(Projections.property("id"), "id")
                .add(Projections.property("name"), "name")
                .add(Projections.property("email"), "email")
                       .add(Projections.property("fee"), "fee")
                       .add(Projections.property("sname"), "sname")
                .add(Projections.property("contactno"), "contactno")
        );
        criteria.add(Restrictions.eq("id", id));
        criteria.setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP);
        List list = criteria.list();
        session.close();
        return list;
    }

    public void update(Details Stdinfo){
        Session session = sessionFactory.openSession();
        Transaction trx = session.beginTransaction();
        
        session.update(Stdinfo);
        trx.commit();
        session.close();
    }      
}

web.xml #

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
  metadata-complete="true">
    
     <welcome-file-list>
     <welcome-file>index.htm</welcome-file>
 </welcome-file-list>
    
     <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>2</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>*.htm</url-pattern>
    </servlet-mapping>
    </web-app>

解决方案 #

核心原因 #

NoClassDefFoundError: [Lorg/hibernate/engine/FilterDefinition; 说明项目运行时找不到Hibernate的FilterDefinition数组类，本质是Hibernate版本与Spring提供的Hibernate3整合包不兼容，或者缺少Hibernate核心依赖包。

具体修复步骤 #

1. 统一Hibernate版本与Spring整合包：

   • 当前使用org.springframework.orm.hibernate3相关类，必须搭配Hibernate 3.x版本。若误引入Hibernate 4+版本，会出现类缺失问题。
   • 确保项目中所有Hibernate依赖为3.x系列，比如hibernate-core-3.6.10.Final.jar、hibernate-annotations-3.5.6-Final.jar等。

2. 检查依赖完整性：

   • 确认以下Hibernate核心包已添加到项目WEB-INF/lib目录：
     • hibernate-core.jar
     • hibernate-annotations.jar
     • hibernate-commons-annotations.jar
     • hibernate-jpa-2.0-api.jar
     • javassist.jar（Hibernate依赖的字节码处理库）

3. 优化SessionFactory配置（可选）：

   • 若升级到Hibernate 4.x，需将AnnotationSessionFactoryBean替换为org.springframework.orm.hibernate4.LocalSessionFactoryBean，事务管理器替换为org.springframework.orm.hibernate4.HibernateTransactionManager，同时更新Hibernate依赖为4.x版本（Spring 4.0.1兼容Hibernate 4.x）。

4. 修正DAO层Session使用方式：

   • 当前DAO手动调用openSession()和close()，结合@Transactional注解会导致事务管理失效。建议改为获取事务绑定的Session，无需手动关闭：

     public void save(Details stdinfo) {
         Session session = sessionFactory.getCurrentSession();
         session.save(stdinfo);
     }
     

   • 同时在dispatcher-servlet.xml中开启事务注解支持：

     <tx:annotation-driven transaction-manager="hibernateTransactionManager"/>
     

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