一、事務傳播行為的基本概念
事務傳播行為是Spring 框架中事務管理的核心概念，用于定義當一個事務方法被另一個事務方法調用時，事務應如何傳播。通俗地說，它解決了 “多個事務方法嵌套調用時，新方法是加入現有事務還是創建新事務” 的問題。
事務傳播行為詳解
在 Spring 中，事務傳播行為通過@Transactional注解的propagation屬性設置，或在TransactionDefinition接口中定義。
二、Spring 事務傳播行為的類型及詳解
Spring 定義了 7 種事務傳播行為，以下是詳細說明：
| 傳播行為類型 | 英文名稱 | 核心定義 | 典型應用場景 |
|---|---|---|---|
| PROPAGATION_REQUIRED （propagation_required） | REQUIRED（默認） | 若當前存在事務，則加入該事務；若不存在，則創建新事務。 | 核心業務邏輯（如訂單創建、支付流程），確保操作在統一事務中。 |
| PROPAGATION_REQUIRES_NEW (propagation_requires_new) | REQUIRES_NEW | 無論當前是否存在事務，都創建新事務，原事務會被掛起。 | 異步任務、日志記錄（不希望主事務失敗影響子任務），或需要獨立回滾的操作。 |
| PROPAGATION_NESTED (propagation_nested) | NESTED | 若當前存在事務，則創建嵌套事務（通過數據庫 Savepoint 實現）；若不存在，則創建新事務。 | MySQL 等支持 Savepoint 的數據庫中，需要部分回滾的場景（如訂單部分退款）。 |
| PROPAGATION_SUPPORTS (propagation_supports) | SUPPORTS | 若當前存在事務，則加入事務；若不存在，則以非事務方式執行。 | 只讀查詢方法，可復用外層事務，也可獨立執行。 |
| PROPAGATION_NOT_SUPPORTED (propagation_not_supported) | NOT_SUPPORTED | 以非事務方式執行，若當前存在事務，則掛起該事務。 | 明確不需要事務的操作（如緩存更新），避免事務開銷。 |
| PROPAGATION_NEVER (propagation_never) | NEVER | 強制以非事務方式執行，若當前存在事務，則拋出異常。 | 確保方法絕對不運行在事務中（如只讀緩存服務）。 |
| PROPAGATION_MANDATORY (propagation_mandatory) | MANDATORY | 強制要求當前存在事務，否則拋出異常。 | 子方法必須依賴外層事務（如財務系統中的分賬操作）。 |
三、（@Transactional注解的propagation屬性）的生效條件和觸發時機
Spring事務傳播行為（@Transactional注解的propagation屬性）的生效條件和觸發時機需要結合以下幾點來理解：
1. 注解何時起作用？
Spring事務傳播行為的注解（如@Transactional(propagation = Propagation.REQUIRED)）會在以下場景中生效：
- 方法被調用時：當一個事務方法（帶有@Transactional注解）被另一個方法調用時，事務傳播行為會根據當前事務上下文動態決定如何處理事務。
- 代理機制觸發：Spring通過動態代理（JDK動態代理或CGLIB代理）管理事務。只有當方法是通過代理對象調用時，事務傳播行為才會生效。
2.事務傳播行為的觸發流程
事務傳播行為的觸發流程可以簡化為以下步驟：
方法調用時檢查事務上下文：Spring會檢查當前是否存在事務（例如，調用方是否已經開啟事務）。
根據傳播行為決定事務處理方式：
- 新建事務（如REQUIRES_NEW）：掛起當前事務（如果有），開啟新事務。
- 加入事務（如REQUIRED）：直接使用當前事務。
- 強制要求/禁止事務（如MANDATORY/NEVER）：根據規則拋出異常或掛起事務。
執行方法邏輯：在確定事務上下文后，執行方法體內的業務邏輯。
事務提交或回滾：根據方法執行結果和傳播行為規則提交或回滾事務。
3.示例代碼
REQUIRED 傳播行為的核心原則 “如果存在事務則加入，不存在則創建新事務” 是針對每個被調用的方法而言的。具體邏輯如下：
⑴. 核心判斷時機
當一個被 @Transactional(propagation = Propagation.REQUIRED) 注解的方法被調用時，Spring 會檢查當前調用環境是否存在活躍事務：
- 如果存在事務：方法會加入該事務，共享同一事務上下文。
- 如果不存在事務：方法會創建一個新事務。
⑵. 示例說明
場景一：調用鏈中已有事務
@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {// 事務已創建methodB(); // 調用 methodB
}@Transactional(propagation = Propagation.REQUIRED)
public void methodB() {// methodB 加入 methodA 的事務
}- 分析：
methodB?被調用時，由于調用鏈中已存在?methodA?創建的事務，methodB?直接加入該事務，兩者共享同一事務邊界。
場景二：調用鏈中無事務
public void methodA() {// 無事務methodB(); // 調用 methodB
}@Transactional(propagation = Propagation.REQUIRED)
public void methodB() {// methodB 創建新事務
}- 分析：
methodB?被調用時，由于調用鏈中不存在事務，methodB?會創建一個新事務。
⑶.?關鍵點
- 與方法層級無關：無論方法是被直接調用還是嵌套在多層調用鏈中，判斷邏輯始終是當前調用環境是否存在事務。
- 事務上下文由 Spring 維護：Spring 通過?
TransactionSynchronizationManager?管理事務上下文，確保同一線程中共享事務狀態。 - 自調用問題：若方法在同一個類中被自調用（如?
this.methodB()），@Transactional?注解會失效，因為 Spring 的 AOP 代理機制只攔截外部調用。
"在同一事務中" 的含義
四、核心傳播行為的典型場景與示例
1.propagation_required（默認行為）
這是最常用的傳播行為。如果當前存在事務，則加入該事務；如果不存在，則創建一個新事務。
應用場景：核心業務邏輯，確保多個操作在同一事務中。
示例：創建訂單并扣減庫存
@Service
public class OrderService {@Autowiredprivate OrderRepository orderRepository;@Autowiredprivate InventoryService inventoryService;@Transactional(propagation = Propagation.REQUIRED)public Order createOrder(Order order) {// 保存訂單Order savedOrder = orderRepository.save(order);// 扣減庫存 (假設該方法也使用 REQUIRED 傳播行為)inventoryService.reduceStock(order.getProductId(), order.getQuantity());return savedOrder;}
}在這個例子中，如果?createOrder?方法被一個事務調用，reduceStock?方法會加入這個事務；如果沒有事務，這兩個操作會在一個新事務中執行。
2.propagation_requires_new
無論當前是否存在事務，都創建一個新事務，原事務會被掛起。
應用場景：異步任務、日志記錄，不希望主事務失敗影響子任務。
示例：訂單支付與日志記錄
@Service
public class PaymentService {@Autowiredprivate LogService logService;@Transactional(propagation = Propagation.REQUIRED)public void processPayment(Payment payment) {// 處理支付try {// 支付邏輯...// 記錄支付日志 (使用 REQUIRES_NEW 確保即使主事務回滾，日志也會記錄)logService.recordPaymentLog(payment);// 可能拋出異常的操作if (payment.getAmount() > 10000) {throw new PaymentException("金額過大需要審核");}} catch (Exception e) {// 異常處理}}
}@Service
public class LogService {@Transactional(propagation = Propagation.REQUIRES_NEW)public void recordPaymentLog(Payment payment) {// 記錄日志邏輯}
}在這個例子中，即使?processPayment?方法因異常回滾，recordPaymentLog?方法創建的日志記錄也會被持久化，因為它在獨立的事務中執行。
3.propagation_nested
如果當前存在事務，則創建一個嵌套事務（通過數據庫 Savepoint 實現）；如果不存在，則創建一個新事務。
應用場景：需要部分回滾的場景，如訂單部分退款。
示例：訂單部分退款
@Service
public class RefundService {@Autowiredprivate OrderRepository orderRepository;@Autowiredprivate PaymentRepository paymentRepository;@Transactional(propagation = Propagation.REQUIRED)public void processPartialRefund(Long orderId, BigDecimal refundAmount) {Order order = orderRepository.findById(orderId).orElseThrow();// 創建嵌套事務處理退款try {refundPayment(order.getPaymentId(), refundAmount);// 更新訂單狀態order.setStatus(OrderStatus.PARTIALLY_REFUNDED);orderRepository.save(order);} catch (RefundException e) {// 退款失敗，但訂單狀態更新不會受影響// 嵌套事務的回滾不會影響外層事務order.setStatus(OrderStatus.REFUND_FAILED);orderRepository.save(order);}}@Transactional(propagation = Propagation.NESTED)public void refundPayment(Long paymentId, BigDecimal amount) {// 退款邏輯if (amount > 1000) {throw new RefundException("退款金額超過限制");}// 執行退款...}
}在這個例子中，如果?refundPayment?方法拋出異常，只會回滾嵌套事務中的操作，而外層事務中的訂單狀態更新仍然會提交。
4.propagation_supports
如果當前存在事務，則加入事務；如果不存在，則以非事務方式執行。
應用場景：只讀查詢方法，可以復用外層事務，也可以獨立執行。
示例：查詢訂單詳情
@Service
public class OrderQueryService {@Autowiredprivate OrderRepository orderRepository;@Transactional(propagation = Propagation.SUPPORTS, readOnly = true)public Order getOrderDetails(Long orderId) {// 查詢訂單詳情return orderRepository.findById(orderId).orElseThrow();}
}在這個例子中，如果?getOrderDetails?方法在事務中被調用，它會加入該事務；如果不在事務中，它會以非事務方式執行。這對于只讀操作很有用，可以減少事務開銷。
5.propagation_not_supported
以非事務方式執行，如果當前存在事務，則掛起該事務。
應用場景：明確不需要事務的操作，如緩存更新。
示例：更新緩存
@Service
public class CacheService {@Transactional(propagation = Propagation.NOT_SUPPORTED)public void updateCache(String key, Object value) {// 更新緩存邏輯// 這里不需要事務，因為緩存操作通常不需要回滾}
}在這個例子中，如果?updateCache?方法在事務中被調用，當前事務會被掛起，方法執行完畢后再恢復。
6.propagation_never
強制以非事務方式執行，如果當前存在事務，則拋出異常。
應用場景：確保方法絕對不運行在事務中，如只讀緩存服務。
示例：從緩存獲取數據
@Service
public class CacheQueryService {@Transactional(propagation = Propagation.NEVER)public Object getFromCache(String key) {// 從緩存獲取數據// 確保此方法不會在事務中執行return cache.get(key);}
}在這個例子中，如果?getFromCache?方法在事務中被調用，會拋出異常，確保緩存操作不會在事務上下文中執行。
7.propagation_mandatory
強制要求當前存在事務，否則拋出異常。
應用場景：子方法必須依賴外層事務，如財務系統中的分賬操作。
示例：財務分賬
@Service
public class AccountingService {@Transactional(propagation = Propagation.MANDATORY)public void distributeFunds(Payment payment) {// 分賬邏輯// 必須在事務中執行，確保數據一致性}
}@Service
public class PaymentProcessingService {@Autowiredprivate AccountingService accountingService;@Transactional(propagation = Propagation.REQUIRED)public void processPayment(Payment payment) {// 處理支付// ...// 分賬 (依賴外層事務)accountingService.distributeFunds(payment);}
}在這個例子中，distributeFunds?方法必須在事務中調用，否則會拋出異常。這確保了分賬操作不會在沒有事務保護的情況下執行。
五、事務傳播行為的底層實現原理
-
數據庫事務與 Spring 事務的映射：
- Spring 通過
PlatformTransactionManager抽象層管理事務，不同數據庫（如 MySQL、Oracle）的事務機制會影響傳播行為的實現。 - 例如：
PROPAGATION_NESTED依賴數據庫的SAVEPOINT機制，MySQL InnoDB 引擎支持，而 MyISAM 不支持。
- Spring 通過
-
事務掛起與恢復：
- 當使用
REQUIRES_NEW或NESTED時，Spring 會將當前事務狀態（如連接、隔離級別）保存到TransactionStatus對象中，新事務完成后恢復原事務。
- 當使用
六、實戰最佳實踐與注意事項
-
優先使用默認傳播行為（REQUIRED）：
- 核心業務邏輯通常需要事務一致性，默認值可避免遺漏配置。
-
REQUIRES_NEW 的性能開銷：
- 新事務會導致數據庫連接切換和事務日志開銷，非必要場景避免濫用。
-
NESTED 的數據庫兼容性：
- 若系統需跨數據庫部署，謹慎使用
NESTED，可考慮用REQUIRES_NEW替代。
- 若系統需跨數據庫部署，謹慎使用
-
事務邊界控制：
- 避免在循環中調用
REQUIRES_NEW方法（如批量插入），可通過@Transactional包裹整個循環以減少事務開銷。
- 避免在循環中調用
-
異常處理與事務回滾：
- 傳播行為會影響異常傳播，例如
REQUIRES_NEW的子事務異常不會影響外層事務，需顯式處理異常或配置rollbackFor。
- 傳播行為會影響異常傳播，例如
七、總結
事務傳播行為是 Spring 事務管理的核心機制，合理選擇傳播行為可解決以下問題：
- 多個服務方法間的事務邊界劃分
- 核心業務與輔助操作的事務隔離
- 復雜業務流程中的部分回滾需求
為何必須同步調用？)
