SpringBoot項目中建議關閉Open-EntityManager-in-view原因

Posted on by

前言

一天，開發突然找過來說KLock分佈式鎖失效瞭，高並發情況下沒有鎖住請求，導致數據庫拋樂觀鎖的異常。一開始我是不信的，KLock是經過線上大量驗證的，怎麼會出現這麼低級的問題呢？然後，協助開發一起排查瞭一下午，最後經過不懈努力和一探到底的摸索精神最終查明不是KLock鎖的問題，問題出在Spring Data Jpa的Open-EntityManager-in-view這個配置上，這裡先建議各位看官關閉Open-EntityManager-in-view，具體緣由下面慢慢道來

問題背景

假設我們有一張賬戶表account，業務邏輯是先用id查詢出來，校驗下，然後用於其他的邏輯操作，最後在用id查詢出來更新這個account，業務流程如下：

  • 請求一:
    查詢id =6的記錄，此時JpaVersion =6，業務處理，再次查詢id =6的記錄，JpaVersion =6,然後更新數據提交
  • 請求二:
    查詢id =6的記錄，此時JpaVersion =6, 業務處理，此時請求一結束瞭，再次查詢id=6的記錄，JpaVersion =6，更新數據提交失敗

首先，請求一和請求二是模擬的並發請求，然後問題出在，當請求一事務正常提交結束後，請求二最後一次查詢的JpaVersion還是沒有變化，導致瞭當前版本和數據庫中的版本不一致二拋樂觀鎖異常，而KLock鎖是加在第二次查詢更新的方法上面的，可以肯定KLock鎖沒有問題，鎖住瞭請求，直到請求一結束後，請求二才進方法。

2019-11-20 18:32:00.573 [/] pay-settlement-app [http-nio-8086-exec-4] ERROR c.k.p.p.s.a.e.ControllerExceptionHandler - Batch update returned unexpected row count from update [0]; actual row count: 0; expected: 1; nested exception is org.hibernate.StaleStateException: Batch update returned unexpected row count from update [0]; actual row count: 0; expected: 1 org.springframework.orm.ObjectOptimisticLockingFailureException: Batch update returned unexpected row count from update [0]; actual row count: 0; expected: 1; nested exception is org.hibernate.StaleStateException: Batch update returned unexpected row count from update [0]; actual row count: 0; expected: 1 at org.springframework.orm.jpa.vendor.HibernateJpaDialect.convertHibernateAccessException(HibernateJpaDialect.java:320)
    at org.springframework.orm.jpa.vendor.HibernateJpaDialect.translateExceptionIfPossible(HibernateJpaDialect.java:244)
    at org.springframework.orm.jpa.AbstractEntityManagerFactoryBean.translateExceptionIfPossible(AbstractEntityManagerFactoryBean.java:488)
    at org.springframework.dao.support.ChainedPersistenceExceptionTranslator.translateExceptionIfPossible(ChainedPersistenceExceptionTranslator.java:59)
    at org.springframework.dao.support.DataAccessUtils.translateIfNecessary(DataAccessUtils.java:213)
    at org.springframework.dao.support.PersistenceExceptionTranslationInterceptor.invoke(PersistenceExceptionTranslationInterceptor.java:147)
    at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:179)
    at org.springframework.data.jpa.repository.support.CrudMethodMetadataPostProcessor$CrudMethodMetadataPopulatingMethodInterceptor.invoke(CrudMethodMetadataPostProcessor.java:133)
    at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:179)
    at org.springframework.aop.interceptor.ExposeInvocationInterceptor.invoke(ExposeInvocationInterceptor.java:92)
    at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:179)

OPEN-ENTITYMANAGER-IN-VIEW的前世今生

Open-EntityManager-in-view簡述下就是在視圖層打開EntityManager，spring boot2.x中默認是開啟這個配置的，作用是綁定EntityManager到當前線程中，然後在試圖層就開啟Hibernate Session。用於在Controller層直接操作遊離態的對象，以及懶加載查詢。在應用配置中可以使用spring.jpa.open-in-view=true/false來開啟和關閉它，最終控制的其實是OpenEntityManagerInViewInterceptor攔截器，如果開啟就添加此攔截器，如果關閉則不添加。然後在這個攔截器中會開啟連接，打開Session，業務Controller執行完畢後關閉資源。打開關閉代碼如下：

public void preHandle(WebRequest request) throws DataAccessException {
		String key = getParticipateAttributeName();
		WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager(request);
		if (asyncManager.hasConcurrentResult() && applyEntityManagerBindingInterceptor(asyncManager, key)) {
			return;
		}
		EntityManagerFactory emf = obtainEntityManagerFactory();
		if (TransactionSynchronizationManager.hasResource(emf)) {
			// Do not modify the EntityManager: just mark the request accordingly.
			Integer count = (Integer) request.getAttribute(key, WebRequest.SCOPE_REQUEST);
			int newCount = (count != null ? count + 1 : 1);
			request.setAttribute(getParticipateAttributeName(), newCount, WebRequest.SCOPE_REQUEST);
		}
		else {
			logger.debug("Opening JPA EntityManager in OpenEntityManagerInViewInterceptor");
			try {
				EntityManager em = createEntityManager();
				EntityManagerHolder emHolder = new EntityManagerHolder(em);
				TransactionSynchronizationManager.bindResource(emf, emHolder);
				AsyncRequestInterceptor interceptor = new AsyncRequestInterceptor(emf, emHolder);
				asyncManager.registerCallableInterceptor(key, interceptor);
				asyncManager.registerDeferredResultInterceptor(key, interceptor);
			}
			catch (PersistenceException ex) {
				throw new DataAccessResourceFailureException("Could not create JPA EntityManager", ex);
			}
		}
	}
	public void afterCompletion(WebRequest request, @Nullable Exception ex) throws DataAccessException {
		if (!decrementParticipateCount(request)) {
			EntityManagerHolder emHolder = (EntityManagerHolder)
					TransactionSynchronizationManager.unbindResource(obtainEntityManagerFactory());
			logger.debug("Closing JPA EntityManager in OpenEntityManagerInViewInterceptor");
			EntityManagerFactoryUtils.closeEntityManager(emHolder.getEntityManager());
		}
	}

在Spring MVC時代，懶加載的問題也比較常見，那個時候是通過定義一個OpenEntityManagerInViewFilter的過濾器解決問題的，效果和攔截器是一樣的，算是同門師兄弟的關系。如果沒有配置，在懶加載的場景下就會拋出LazyInitializationException的異常。

問題的真實原因

瞭解瞭Open-EntityManager-in-view後，我們來分析下具體的原因。由於在view層就開啟Session瞭，導致瞭同一個請求第二次查詢時根本就沒走數據庫，直接獲取的Hibernate Session緩存中的數據，此時無論怎麼加鎖，都讀不到數據庫中的數據，所以隻要有並發就會拋樂觀鎖異常。這讓我聯想到瞭老早前一個同事和我說的他們遇到的一個並發問題，即使給@Transactional事務的隔離級別設置為串行化執行，還是會報樂觀鎖的異常。有可能就是這個問題導致的，在這個案例中，加鎖不好使，即使使用數據庫的串行化隔離級別也不好使。因為第二次查詢根本就不走數據庫瞭。

解決方案

真實原因已經定位到瞭，KL博主給出瞭幾種方案解決問題，如下：

  • 方案一、將KLock前置，把加分佈式鎖的邏輯移到第一次使用id查詢之前，即讓查詢發生在別的請求事務結束之前，這樣無論第一次查詢還是第二次查詢獲取到的都是別的事務已提交的內容
  • 方案二、使用spring.jpa.open-in-view=false關閉，這個方案比較簡單粗暴，但是影響會比較大，其他的代碼很可能已經依賴瞭懶加載的功能特性，貿然去掉會帶來大量的回歸測試工作，所以雖然博主建議關閉這個特性，但是在已經使用瞭的系統中不推薦
  • 方案三、局部控制Open-EntityManager-in-view行為，就是人為編碼控制EntityManager的綁定，在有影響的地方先取消綁定，然後執行完後在添加回來，不添加回來會導致Jpa自己的解綁邏輯報錯。代碼如下：
/**
 * @author: kl @kailing.pub
 * @date: 2019/11/20
 */
@Component
public class OpenEntityManagerInViewManager extends EntityManagerFactoryAccessor {
    public void cancel() {
        EntityManagerFactory emf = obtainEntityManagerFactory();
        EntityManagerHolder emHolder = (EntityManagerHolder) TransactionSynchronizationManager.unbindResourceIfPossible(emf);
        EntityManagerFactoryUtils.closeEntityManager(emHolder.getEntityManager());
    }
    public void add() {
        EntityManagerFactory emf = obtainEntityManagerFactory();
        if (!TransactionSynchronizationManager.hasResource(emf)) {
            EntityManager em = createEntityManager();
            EntityManagerHolder emHolder = new EntityManagerHolder(em);
            TransactionSynchronizationManager.bindResource(emf,emHolder);
        }
    }
}
  • 方案四:方案三為瞭達到效果有點費勁哈，其實還有一種方案，在第二次查詢前使用EntityManager的clear清除Session緩存即可，

建議關閉OPEN-ENTITYMANAGER-IN-VIEW

在Spring boot2.x中，如果沒有顯示配置spring.jpa.open-in-view，默認開啟的這個特性Spring會給出一個警告提示：

logger.warn("spring.jpa.open-in-view is enabled by default. "
                        + "Therefore, database queries may be performed during view "
                        + "rendering. Explicitly configure spring.jpa.open-in-view to disable this warning");

用來告訴你，我開啟這個特性瞭，你可以顯示配置來關閉這個提示。博主猜測就是告知用戶，你可能用不著吧。確實，現在微服務中的應用在使用Spring Data JPA時，已經很少使用懶加載的特性瞭。而且如果你的代碼規范點，也用不著直接在Controller層寫Dao層的代碼。總結下就是根本就不需要Open-EntityManager-in-view的特性，然後它還有副作用，開啟Open-EntityManager-in-view，會使數據庫租用連接時長變長，長時間占用連接直接影響整體事務吞吐量。然後一不小心就會陷進Session緩存的坑裡。所以，新項目就直接去掉吧，老項目去掉後回歸驗證下

結語

因為對業務不熟悉，不知道業務邏輯中查詢瞭兩次相同的實體，導致整個排錯過程比較曲折。先是開發懷疑鎖的問題，驗證鎖沒問題後，又陷進瞭IDEA斷點的問題，因為模擬的並發請求，斷點釋放一次會通過多個請求，看上去就像很多請求沒進來一樣。然後又懷疑瞭事務和加鎖前後的邏輯問題，如果釋放鎖在釋放事務前就會有問題，將斷點打在瞭JDBC的Commit方法裡，確認瞭這個也是正常的。最後才聯想到Spring boot中默認開啟瞭spring.jpa.open-in-view，會不會有關系，也不確定，懷著死馬當活馬醫的心態試瞭下，果然是這個導致的，這個時候隻知道是這個導致的，還沒發現是這個導致的Session問題，以為是進KLock前就開啟瞭事務鎖定瞭數據庫版本記錄，所以查詢的時候返回的老的記錄，最後把事務串行化後還不行，才發現的業務查詢瞭兩次進而發現瞭Session緩存的問題。至此，水落石出，所有問題迎刃而解。

以上就是SpringBoot項目中建議關閉Open-EntityManager-in-view原因的詳細內容，更多關於Spring Boot關閉Open-EntityManager-in-view的資料請關註WalkonNet其它相關文章！

 

推薦閱讀：