概述

Kafka的強大功能之一是每個分區都有一個Consumer的偏移值。該偏移值是消費者將讀取的下一條消息的值。可以自動或手動增加該值。如果我們由于錯誤而無法處理消息并想重試，我們可以選擇手動管理，并在成功的情況下增加偏移量。但是，這會暫時阻止隊列消息的處理。我們可以選擇異步方法。

為什么我們需要它？

如果發生錯誤，而不是停止隊列消息的處理；我們可以將錯誤消息轉移到不同的主題并再次處理。

如果在處理 Kafka 消息時出現錯誤，可以使用 RetryableTopic 注解以一定的時間間隔和一定的次數再次處理消息。如果完成嘗試次數后錯誤仍然存在，則消息將發送到 DLT 隊列。

如何使用？

我們首先回顧一下RetryableTopic注解可以取的一些值，以便您可以做出最適合您的設置：

attempts：嘗試處理消息的次數。它的默認值為 3。如果完成所有嘗試后仍然收到錯誤，則消息將發送到 DLT 隊列。

backoff：用于確定處理消息的時間間隔。從 Backoff 類獲取一個值。您可以在下面找到退避的詳細示例。

排除/排除名稱：允許您排除指定的異常類。當您添加到列表中的任何錯誤被拋出時，重試機制將不會被激活。

include / includeNames：僅當拋出指定的異常時才會激活重試機制。

kafkaTemplate：雖然您可以給出現有 kafkaTemplate bean 的名稱，但您也可以為特定于重試的 Kafka 模板定義不同的 bean。

autoCreateTopics：決定是否自動創建Retry和DLT主題。

retryTopicSuffix / dltTopicSuffix：用于確定要添加到自動創建的主題末尾的后綴。

dltStrategy：如果不需要DLT，可以定義為NO_DLT。

SameIntervalTopicReuseStrategy/fixedDelayTopicStrategy（3.0.4之前）：用于確定要創建的重試主題策略。創建 (SINGLE_TOPIC) 或盡可能多的嘗試值 (MULTIPLE_TOPICS) 重試主題。

Backoff的示例：

• 具有固定的增量值

Backoff(delay = 600000 ) // 每 10 分鐘

• 具有指數價值

Backoff(delay = 60000 , multiplier = 2 ) // 1、2、4、8... 分鐘后重復。

• 用占位符定義值

Backoff(delayExpression = "${delay}", multiplierExpression = "${multiplier}")

@RetryableTopic 示例：

@RetryableTopic(
     backoff = @Backoff(delay = 300000),
     attempts = 12,
     sameIntervalTopicReuseStrategy = 
         SameIntervalTopicReuseStrategy.SINGLE_TOPIC,
     kafkaTemplate = "kafkaRetryableTopicTemplate",
     exclude = { SerializationException.class, 
                 DeserializationException.class, 
                 NullPointerException.class 
               }
 )
 @KafkaListener(topics = "my-topic")
 public void processMessage(RetryableDto retryableDto) {
     log.info("Retrying process RetryableDto : {}", retryableDto);
     // process message
 }

在上面的例子中，消息將每5分鐘重新處理一次，總共12次，即1小時。如果任何嘗試均順利完成，則試用將終止。

由于定義了 SINGLE_TOPIC，因此將創建單個主題以進行重試。如果沒有進行此定義，則會創建 12 個重試主題。

如果拋出了排除中定義的任何錯誤，則不會執行重做。

如果需要，您可以編寫自己的 RetryableException 并在包含中定義此值，以便僅在引發此錯誤時才重試。

DLT隊列處理

如果完成了定義的嘗試次數并且繼續收到錯誤，則消息將發送到 DLT 隊列。如果要處理這些消息，可以使用DltHandler注解。

用法示例：

@DltHandler 
 public  void  handleDltMessage (RetryableDto retryableDto) { 
     log.error("DLT處理程序消息：{}", retryableDto); 
}

注意事項

雖然使用 RetryableTopic 的異步處理優勢為我們帶來了性能提升，但這種使用也有一些缺點。

使用RetryableTopic可能會破壞消息的處理順序。

讓我們用一個例子來解釋這種情況：當主主題在時間 t 處理時，一條消息出錯并被發送到重試主題。在時間 t + 1 時，另一條消息來到主主題并成功處理。讓我們在重試主題中的消息在時間 t + 2 時被成功處理。在這種情況下，第一條傳入消息將在第二條消息之后處理。如果訂購對您很重要，我建議您在消息處理過程中進行必要的檢查。

另一個缺點是消息雙重處理的風險。您可以通過考慮這種可能性來進行改進。