No qualifying bean of type [javax.persistence.EntityManage] 异常问题的解决

àì夳堔傛蜴生んèń 2022-08-06 11:26 174阅读 0赞

引言： 在Spring Web项目中一般都会使用OpenEntityManagerInViewFilter来保证JPA session的正常关闭，在笔者的项目中，使用了Spring + Spring Data + JPA + Hibernate来的架构来组织项目，碰到了org.springframework.beans.factory.NoSuchBeanDefinitionException: No bean named 'entityManagerFactory' is defined 的异常信息，将过一番查找之后，方才发现问题是加载顺序的问题....

1. 项目背景介绍

项目中使用的技术有： Spring+Spring Data, JPA, Hibernate等来贯穿项目的主题架构。

2.  Session异常关闭的处理机制

在Java Web项目中使用Hibernate经常会遇到LazyInitializationException 。这是因为controller和model层（java代码）将通过JPA的一些启用了延迟加载功能 的领域（如用getRefrence() 方法或者在关联关系中采用fetch=FetchType.LAZY ）返回给view层（jsp代码）的时候，由于加载领域对象的JPA Session已经关闭，导致这些延迟加载的数据访问异常。

这时就可以使用OpenEntityManagerInViewFilter来将一个JPAsession与一次完整的请求过程对应的线程相绑定。

解决办法：

<filter>  
            <filter-name>Spring OpenEntityManagerInViewFilter</filter-name>  
            <filter-class>org.springframework.orm.jpa.support.OpenEntityManagerInViewFilter</filter-class>  
            <init-param>  
              
                <param-name>entityManagerFactoryBeanName</param-name>  
                <param-value>entityManagerFactory</param-value>  
            </init-param>   
        </filter>  
        <filter-mapping>  
            <filter-name>Spring OpenEntityManagerInViewFilter</filter-name>  
            <url-pattern>/*</url-pattern>  
        </filter-mapping>

3. 异常问题的出现

在解决了Session异常关闭之后，在启动服务器的时候，就出现了如下异常信息：

org.springframework.beans.factory.NoSuchBeanDefinitionException: No bean named 'entityManagerFactory' is defined
    	at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBeanDefinition(DefaultListableBeanFactory.java:575)
    	at org.springframework.beans.factory.support.AbstractBeanFactory.getMergedLocalBeanDefinition(AbstractBeanFactory.java:1111)
    	at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:276)
    	at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:195)
    	at org.springframework.context.support.AbstractApplicationContext.getBean(AbstractApplicationContext.java:1121)
    	at org.springframework.orm.jpa.support.OpenEntityManagerInViewFilter.lookupEntityManagerFactory(OpenEntityManagerInViewFilter.java:222)
    	at org.springframework.orm.jpa.support.OpenEntityManagerInViewFilter.lookupEntityManagerFactory(OpenEntityManagerInViewFilter.java:205)
    	at org.springframework.orm.jpa.support.OpenEntityManagerInViewFilter.doFilterInternal(OpenEntityManagerInViewFilter.java:150)
    	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:106)
    	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
    	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
    	at org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:88)
    	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:106)
    	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
    	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
    	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:220)
    	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:122)
    	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:501)
    	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:170)
    	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:98)
    	at org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:950)
    	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
    	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:408)
    	at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1040)
    	at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:607)
    	at org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:313)
    	at java.util.concurrent.ThreadPoolExecutor$Worker.runTask(ThreadPoolExecutor.java:886)
    	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:908)
    	at java.lang.Thread.run(Thread.java:662)

从异常信息的分析可知道，OpenEntityManagerInViewFilter中对entityManagerFactory有依赖，需要对其在Spring中声明的实例依赖。 但是没有找到合适的实例。

可是entityManagerFactory的确已经声明在了spring的配置文件之中了。问题在哪里呢？

4. 问题分析以及定位

项目中entityManagerFactory在Spring中的配置文件定义的，经过检查，工作正常，不存在问题。

<beans:bean id="entityManagerFactory"
    		class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
    		<beans:property name="dataSource" ref="dataSource" />
           
    		<beans:property name="jpaVendorAdapter">
    			<beans:bean
    				class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter">
    				
    			</beans:bean>
    		</beans:property>
    
    		<beans:property name="persistenceUnitName" value="myPersistenceUnit" />
    		<beans:property name="packagesToScan">
    			<beans:list>
    				<beans:value>com.creditease.bsettle.pay.model</beans:value>
    			</beans:list>
    		</beans:property>
    
    		<beans:property name="loadTimeWeaver">
    			<beans:bean
    				class="org.springframework.instrument.classloading.InstrumentationLoadTimeWeaver" />
    		</beans:property>
    		<beans:property name="jpaPropertyMap">
    			<beans:map>
    				<beans:entry key="showSql" value="true"></beans:entry>
    				<beans:entry key="generateDdl" value="false"></beans:entry>
    				<beans:entry key="hibernate.format_sql" value="true"></beans:entry>
    				<beans:entry key="hibernate.dialect"
    					value="org.hibernate.dialect.Oracle10gDialect"></beans:entry>
    			</beans:map>
    		</beans:property>
    	</beans:bean>

于是把问题的怀疑点聚焦在web.xml初始化文件上，是否其中存在什么问题呢？

在web.xml中存在2个地方进行spring实例的初始化操作：

<context-param>
    		<param-name>contextConfigLocation</param-name>
    		<param-value>classpath:META-INF/spring-config.xml</param-value>
    	</context-param>

第二个位置是：

<servlet>
    		<servlet-name>appServlet</servlet-name>
    		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    		<init-param>
    			<param-name>contextConfigLocation</param-name>
    			<param-value>classpath:META-INF/applicationContext.xml</param-value>
    		</init-param>
    		<load-on-startup>1</load-on-startup>
    	</servlet>

存在错误异常的加载顺序中，entityManagerFactory是在第二个位置中进行加载的。但是 OpenEntityManagerInViewFilter是否加载的顺序在其之前，然后就造成了这样的问题呢？

经过试验，果然是加载顺序的问题，将数据库加载的顺序提前即可。

5. 总结

基于上面的问题，我们可以看到， OpenEntityManagerInViewFilter是在系统启动过程中，优先被加载的，同时其对entityManagerFactory有依赖，就要求同时可以初始化entityManagerFactory的实例。

通过调整初始化的顺序，即可很好的修正上述的问题。

参考资料：

1. http://whoosh.iteye.com/blog/1300721