精确一次语义

您可以为监听器容器提供一个 KafkaAwareTransactionManager 实例。当这样配置时,容器会在调用监听器之前启动一个事务。监听器执行的任何 KafkaTemplate 操作都将参与事务。如果监听器成功处理了记录(或使用 BatchMessageListener 时处理多个记录),则容器会使用 producer.sendOffsetsToTransaction() 将偏移量发送到事务,然后事务管理器提交事务。如果监听器抛出异常,则事务将回滚,并且消费者将重新定位,以便在下次轮询时检索回滚的记录。有关更多信息以及如何处理重复失败的记录,请参阅 回滚后处理器

使用事务可以实现精确一次语义 (EOS)。

这意味着对于一个 read → process → write 序列,保证该序列只执行一次。(读取和处理至少执行一次)。

Spring for Apache Kafka 3.0 及更高版本仅支持 EOSMode.V2

  • V2 - 又称获取偏移量请求围栏(从 2.5 版本开始)

这要求代理版本为 2.5 或更高版本。

使用 V2 模式,不需要为每个 group.id/topic/partition 创建一个生产者,因为消费者元数据会与偏移量一起发送到事务,代理可以使用这些信息来确定生产者是否被围栏。

有关更多信息,请参阅 KIP-447

V2 之前是 BETA 版本;EOSMode 已更改以与 KIP-732 框架保持一致。