【Kafka进阶6】顺序消费深度解析

一、Kafka 顺序消费的核心原理

1.1 Kafka 顺序

Kafka 的顺序保证建立在 分区（Partition） 这一核心概念之上。

#mermaid-svg-QyLvdSLBaEhapjAN{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-QyLvdSLBaEhapjAN .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-QyLvdSLBaEhapjAN .error-icon{fill:#552222;}#mermaid-svg-QyLvdSLBaEhapjAN .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-QyLvdSLBaEhapjAN .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-QyLvdSLBaEhapjAN .marker{fill:#333333;stroke:#333333;}#mermaid-svg-QyLvdSLBaEhapjAN .marker.cross{stroke:#333333;}#mermaid-svg-QyLvdSLBaEhapjAN svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-QyLvdSLBaEhapjAN p{margin:0;}#mermaid-svg-QyLvdSLBaEhapjAN .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-QyLvdSLBaEhapjAN .cluster-label text{fill:#333;}#mermaid-svg-QyLvdSLBaEhapjAN .cluster-label span{color:#333;}#mermaid-svg-QyLvdSLBaEhapjAN .cluster-label span p{background-color:transparent;}#mermaid-svg-QyLvdSLBaEhapjAN .label text,#mermaid-svg-QyLvdSLBaEhapjAN span{fill:#333;color:#333;}#mermaid-svg-QyLvdSLBaEhapjAN .node rect,#mermaid-svg-QyLvdSLBaEhapjAN .node circle,#mermaid-svg-QyLvdSLBaEhapjAN .node ellipse,#mermaid-svg-QyLvdSLBaEhapjAN .node polygon,#mermaid-svg-QyLvdSLBaEhapjAN .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-QyLvdSLBaEhapjAN .rough-node .label text,#mermaid-svg-QyLvdSLBaEhapjAN .node .label text,#mermaid-svg-QyLvdSLBaEhapjAN .image-shape .label,#mermaid-svg-QyLvdSLBaEhapjAN .icon-shape .label{text-anchor:middle;}#mermaid-svg-QyLvdSLBaEhapjAN .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-QyLvdSLBaEhapjAN .rough-node .label,#mermaid-svg-QyLvdSLBaEhapjAN .node .label,#mermaid-svg-QyLvdSLBaEhapjAN .image-shape .label,#mermaid-svg-QyLvdSLBaEhapjAN .icon-shape .label{text-align:center;}#mermaid-svg-QyLvdSLBaEhapjAN .node.clickable{cursor:pointer;}#mermaid-svg-QyLvdSLBaEhapjAN .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-QyLvdSLBaEhapjAN .arrowheadPath{fill:#333333;}#mermaid-svg-QyLvdSLBaEhapjAN .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-QyLvdSLBaEhapjAN .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-QyLvdSLBaEhapjAN .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-QyLvdSLBaEhapjAN .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-QyLvdSLBaEhapjAN .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-QyLvdSLBaEhapjAN .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-QyLvdSLBaEhapjAN .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-QyLvdSLBaEhapjAN .cluster text{fill:#333;}#mermaid-svg-QyLvdSLBaEhapjAN .cluster span{color:#333;}#mermaid-svg-QyLvdSLBaEhapjAN div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-QyLvdSLBaEhapjAN .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-QyLvdSLBaEhapjAN rect.text{fill:none;stroke-width:0;}#mermaid-svg-QyLvdSLBaEhapjAN .icon-shape,#mermaid-svg-QyLvdSLBaEhapjAN .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-QyLvdSLBaEhapjAN .icon-shape p,#mermaid-svg-QyLvdSLBaEhapjAN .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-QyLvdSLBaEhapjAN .icon-shape .label rect,#mermaid-svg-QyLvdSLBaEhapjAN .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-QyLvdSLBaEhapjAN .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-QyLvdSLBaEhapjAN .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-QyLvdSLBaEhapjAN :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

消费者组

生产者

Topic: ORDER_TOPIC

相同Key → 同一分区

相同Key → 同一分区

独占消费

独占消费

独占消费

独占消费

Partition 0

Partition 1

Partition 2

Partition 3

订单ID作为Key

哈希取模

Consumer 1消费 Partition 0,1

Consumer 2消费 Partition 2,3

Kafka 提供的顺序保证：

💡 核心结论：Kafka 只保证分区内有序，不保证全局有序。

1.2 实现顺序消费的关键步骤

#mermaid-svg-W5zGM2Wu1EXevELf{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-W5zGM2Wu1EXevELf .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-W5zGM2Wu1EXevELf .error-icon{fill:#552222;}#mermaid-svg-W5zGM2Wu1EXevELf .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-W5zGM2Wu1EXevELf .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-W5zGM2Wu1EXevELf .marker{fill:#333333;stroke:#333333;}#mermaid-svg-W5zGM2Wu1EXevELf .marker.cross{stroke:#333333;}#mermaid-svg-W5zGM2Wu1EXevELf svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-W5zGM2Wu1EXevELf p{margin:0;}#mermaid-svg-W5zGM2Wu1EXevELf .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-W5zGM2Wu1EXevELf .cluster-label text{fill:#333;}#mermaid-svg-W5zGM2Wu1EXevELf .cluster-label span{color:#333;}#mermaid-svg-W5zGM2Wu1EXevELf .cluster-label span p{background-color:transparent;}#mermaid-svg-W5zGM2Wu1EXevELf .label text,#mermaid-svg-W5zGM2Wu1EXevELf span{fill:#333;color:#333;}#mermaid-svg-W5zGM2Wu1EXevELf .node rect,#mermaid-svg-W5zGM2Wu1EXevELf .node circle,#mermaid-svg-W5zGM2Wu1EXevELf .node ellipse,#mermaid-svg-W5zGM2Wu1EXevELf .node polygon,#mermaid-svg-W5zGM2Wu1EXevELf .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-W5zGM2Wu1EXevELf .rough-node .label text,#mermaid-svg-W5zGM2Wu1EXevELf .node .label text,#mermaid-svg-W5zGM2Wu1EXevELf .image-shape .label,#mermaid-svg-W5zGM2Wu1EXevELf .icon-shape .label{text-anchor:middle;}#mermaid-svg-W5zGM2Wu1EXevELf .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-W5zGM2Wu1EXevELf .rough-node .label,#mermaid-svg-W5zGM2Wu1EXevELf .node .label,#mermaid-svg-W5zGM2Wu1EXevELf .image-shape .label,#mermaid-svg-W5zGM2Wu1EXevELf .icon-shape .label{text-align:center;}#mermaid-svg-W5zGM2Wu1EXevELf .node.clickable{cursor:pointer;}#mermaid-svg-W5zGM2Wu1EXevELf .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-W5zGM2Wu1EXevELf .arrowheadPath{fill:#333333;}#mermaid-svg-W5zGM2Wu1EXevELf .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-W5zGM2Wu1EXevELf .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-W5zGM2Wu1EXevELf .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-W5zGM2Wu1EXevELf .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-W5zGM2Wu1EXevELf .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-W5zGM2Wu1EXevELf .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-W5zGM2Wu1EXevELf .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-W5zGM2Wu1EXevELf .cluster text{fill:#333;}#mermaid-svg-W5zGM2Wu1EXevELf .cluster span{color:#333;}#mermaid-svg-W5zGM2Wu1EXevELf div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-W5zGM2Wu1EXevELf .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-W5zGM2Wu1EXevELf rect.text{fill:none;stroke-width:0;}#mermaid-svg-W5zGM2Wu1EXevELf .icon-shape,#mermaid-svg-W5zGM2Wu1EXevELf .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-W5zGM2Wu1EXevELf .icon-shape p,#mermaid-svg-W5zGM2Wu1EXevELf .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-W5zGM2Wu1EXevELf .icon-shape .label rect,#mermaid-svg-W5zGM2Wu1EXevELf .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-W5zGM2Wu1EXevELf .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-W5zGM2Wu1EXevELf .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-W5zGM2Wu1EXevELf :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

③ 提交方式

手动提交 Offset

业务处理完成后再提交

② 消费端

消费者线程数= 分区数

每个分区独占一个线程

① 生产端

指定 Key

相同 Key哈希到同一分区

二、核心代码实现 💻

2.1 生产者端——指定 Key 路由到同一分区

@Service
public class KafkaOrderProducer {

@Autowired
private KafkaTemplate<String, String> kafkaTemplate;

/**
* 发送顺序消息
* @param orderId 订单ID（作为Key，保证同一订单进入同一分区）
* @param messageBody 消息体
*/
public void sendOrderlyMessage(Long orderId, String messageBody) {
// ✅ 技术亮点：指定 Key，Kafka 默认按 Key 哈希分配到同一个 Partition
// Kafka 使用 MurmurHash2 算法对 Key 进行哈希，与分区数取模决定目标分区
kafkaTemplate.send("ORDER_TOPIC", orderId.toString(), messageBody);
}
}

📌 原理补充：当消息指定了 Key 时，Kafka 使用确定性哈希函数（MurmurHash2）将 Key 映射到固定分区。相同 Key 的消息始终进入同一分区，从而保证顺序。

2.2 消费者端——线程数 = 分区数

@Component
public class KafkaOrderConsumer {

private static final Logger log = LoggerFactory.getLogger(KafkaOrderConsumer.class);

@Autowired
private OrderService orderService;

/**
* 顺序消费消息
* ⚠️ 关键：concurrency 必须等于 Topic 的 Partition 数
* 每个分区只能被一个消费者线程消费
*/
@KafkaListener(
topics = "ORDER_TOPIC",
groupId = "ORDER_CONSUMER_GROUP",
concurrency = "8" // 线程数 = 分区数
)
public void consumeMessage(ConsumerRecord<String, String> record) {
Long orderId = Long.parseLong(record.key());
String messageBody = record.value();

log.info("📨 Kafka顺序消费消息，订单ID：{}，分区：{}，偏移量：{}",
orderId, record.partition(), record.offset());

// 业务逻辑处理
orderService.processOrderMessage(orderId, messageBody);
}
}

⚠️ 重要限制：消费者组内的消费者实例数不能超过分区数，否则多余的消费者将处于空闲状态。

三、技术难点与解决方案 🛡️

3.1 技术难点全景图

3.2 Rebalance 乱序问题深度解析

BrokerConsumer 2(新加入)Group CoordinatorConsumer 1(消费 P0)BrokerConsumer 2(新加入)Group CoordinatorConsumer 1(消费 P0)#mermaid-svg-NSxYG8cWSFJLqChg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-NSxYG8cWSFJLqChg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-NSxYG8cWSFJLqChg .error-icon{fill:#552222;}#mermaid-svg-NSxYG8cWSFJLqChg .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-NSxYG8cWSFJLqChg .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-NSxYG8cWSFJLqChg .marker{fill:#333333;stroke:#333333;}#mermaid-svg-NSxYG8cWSFJLqChg .marker.cross{stroke:#333333;}#mermaid-svg-NSxYG8cWSFJLqChg svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-NSxYG8cWSFJLqChg p{margin:0;}#mermaid-svg-NSxYG8cWSFJLqChg .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-NSxYG8cWSFJLqChg text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-NSxYG8cWSFJLqChg .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-NSxYG8cWSFJLqChg .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-NSxYG8cWSFJLqChg .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-NSxYG8cWSFJLqChg .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-NSxYG8cWSFJLqChg #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-NSxYG8cWSFJLqChg .sequenceNumber{fill:white;}#mermaid-svg-NSxYG8cWSFJLqChg #sequencenumber{fill:#333;}#mermaid-svg-NSxYG8cWSFJLqChg #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-NSxYG8cWSFJLqChg .messageText{fill:#333;stroke:none;}#mermaid-svg-NSxYG8cWSFJLqChg .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-NSxYG8cWSFJLqChg .labelText,#mermaid-svg-NSxYG8cWSFJLqChg .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-NSxYG8cWSFJLqChg .loopText,#mermaid-svg-NSxYG8cWSFJLqChg .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-NSxYG8cWSFJLqChg .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-NSxYG8cWSFJLqChg .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-NSxYG8cWSFJLqChg .noteText,#mermaid-svg-NSxYG8cWSFJLqChg .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-NSxYG8cWSFJLqChg .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-NSxYG8cWSFJLqChg .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-NSxYG8cWSFJLqChg .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-NSxYG8cWSFJLqChg .actorPopupMenu{position:absolute;}#mermaid-svg-NSxYG8cWSFJLqChg .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-NSxYG8cWSFJLqChg .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-NSxYG8cWSFJLqChg .actor-man circle,#mermaid-svg-NSxYG8cWSFJLqChg line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-NSxYG8cWSFJLqChg :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}正在消费 P0，偏移量 100⚠️ 可能从偏移量 90 开始导致短暂重复消费✅ 解决方案：1. 增大 session.timeout.ms2. 使用静态组ID（group.instance.id）3. 业务层幂等兜底❌ 心跳超时触发 Rebalance分配 P0从上次提交偏移量开始消费

💡 Rebalance 并不会破坏分区内的顺序，但可能导致：

• 重复消费：新消费者从上次提交的偏移量开始，可能重复消费已处理但未提交的消息
• 短暂处理中断：重平衡期间消费暂停

四、队头阻塞问题与应对策略 🧩

“这正是队头阻塞问题，面试官您问到点上了 🤓。我们有几套策略，根据业务严重性选择：”

4.1 三种应对策略对比

4.2 订单场景推荐方案：状态机校验 + 死信兜底

#mermaid-svg-b8lDUgjAXNjLf0d9{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-b8lDUgjAXNjLf0d9 .error-icon{fill:#552222;}#mermaid-svg-b8lDUgjAXNjLf0d9 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-b8lDUgjAXNjLf0d9 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .marker.cross{stroke:#333333;}#mermaid-svg-b8lDUgjAXNjLf0d9 svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-b8lDUgjAXNjLf0d9 p{margin:0;}#mermaid-svg-b8lDUgjAXNjLf0d9 .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .cluster-label text{fill:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .cluster-label span{color:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .cluster-label span p{background-color:transparent;}#mermaid-svg-b8lDUgjAXNjLf0d9 .label text,#mermaid-svg-b8lDUgjAXNjLf0d9 span{fill:#333;color:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .node rect,#mermaid-svg-b8lDUgjAXNjLf0d9 .node circle,#mermaid-svg-b8lDUgjAXNjLf0d9 .node ellipse,#mermaid-svg-b8lDUgjAXNjLf0d9 .node polygon,#mermaid-svg-b8lDUgjAXNjLf0d9 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .rough-node .label text,#mermaid-svg-b8lDUgjAXNjLf0d9 .node .label text,#mermaid-svg-b8lDUgjAXNjLf0d9 .image-shape .label,#mermaid-svg-b8lDUgjAXNjLf0d9 .icon-shape .label{text-anchor:middle;}#mermaid-svg-b8lDUgjAXNjLf0d9 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .rough-node .label,#mermaid-svg-b8lDUgjAXNjLf0d9 .node .label,#mermaid-svg-b8lDUgjAXNjLf0d9 .image-shape .label,#mermaid-svg-b8lDUgjAXNjLf0d9 .icon-shape .label{text-align:center;}#mermaid-svg-b8lDUgjAXNjLf0d9 .node.clickable{cursor:pointer;}#mermaid-svg-b8lDUgjAXNjLf0d9 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .arrowheadPath{fill:#333333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-b8lDUgjAXNjLf0d9 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-b8lDUgjAXNjLf0d9 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-b8lDUgjAXNjLf0d9 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-b8lDUgjAXNjLf0d9 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .cluster text{fill:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 .cluster span{color:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-b8lDUgjAXNjLf0d9 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-b8lDUgjAXNjLf0d9 rect.text{fill:none;stroke-width:0;}#mermaid-svg-b8lDUgjAXNjLf0d9 .icon-shape,#mermaid-svg-b8lDUgjAXNjLf0d9 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-b8lDUgjAXNjLf0d9 .icon-shape p,#mermaid-svg-b8lDUgjAXNjLf0d9 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-b8lDUgjAXNjLf0d9 .icon-shape .label rect,#mermaid-svg-b8lDUgjAXNjLf0d9 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-b8lDUgjAXNjLf0d9 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-b8lDUgjAXNjLf0d9 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-b8lDUgjAXNjLf0d9 :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

状态匹配

状态不匹配

否

是

消息到达

状态校验

执行业务逻辑

重试次数是否超限？

✅ 消费成功提交 Offset

⏳ 重试（延迟后重新入队）

📥 转入死信队列

👨‍💻 人工介入修复数据后回调

核心思路：消息体里带前置状态，消费时做乐观锁校验。

— ✅ 支付消息示例：期望前置状态为"待支付"
UPDATE order
SET status = '已支付'
WHERE id = #{orderId}
AND status = '待支付'; — 乐观锁条件

📌 为什么这样有效？

• 如果状态已是 已取消，UPDATE 影响行数为 0，直接 ACK 或移入死信
• 即使历史消息重放，也不会打乱最终结果
• 天然幂等，无需额外去重逻辑

五、幂等性保障——防止重复消息 💪

5.1 重复消息的来源

5.2 幂等性保障方案

#mermaid-svg-tjxW9YmXzMM5Tyx8{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .error-icon{fill:#552222;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .marker.cross{stroke:#333333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 p{margin:0;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .cluster-label text{fill:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .cluster-label span{color:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .cluster-label span p{background-color:transparent;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .label text,#mermaid-svg-tjxW9YmXzMM5Tyx8 span{fill:#333;color:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .node rect,#mermaid-svg-tjxW9YmXzMM5Tyx8 .node circle,#mermaid-svg-tjxW9YmXzMM5Tyx8 .node ellipse,#mermaid-svg-tjxW9YmXzMM5Tyx8 .node polygon,#mermaid-svg-tjxW9YmXzMM5Tyx8 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .rough-node .label text,#mermaid-svg-tjxW9YmXzMM5Tyx8 .node .label text,#mermaid-svg-tjxW9YmXzMM5Tyx8 .image-shape .label,#mermaid-svg-tjxW9YmXzMM5Tyx8 .icon-shape .label{text-anchor:middle;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .rough-node .label,#mermaid-svg-tjxW9YmXzMM5Tyx8 .node .label,#mermaid-svg-tjxW9YmXzMM5Tyx8 .image-shape .label,#mermaid-svg-tjxW9YmXzMM5Tyx8 .icon-shape .label{text-align:center;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .node.clickable{cursor:pointer;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .arrowheadPath{fill:#333333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-tjxW9YmXzMM5Tyx8 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tjxW9YmXzMM5Tyx8 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-tjxW9YmXzMM5Tyx8 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .cluster text{fill:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .cluster span{color:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-tjxW9YmXzMM5Tyx8 rect.text{fill:none;stroke-width:0;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .icon-shape,#mermaid-svg-tjxW9YmXzMM5Tyx8 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .icon-shape p,#mermaid-svg-tjxW9YmXzMM5Tyx8 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .icon-shape .label rect,#mermaid-svg-tjxW9YmXzMM5Tyx8 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tjxW9YmXzMM5Tyx8 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-tjxW9YmXzMM5Tyx8 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-tjxW9YmXzMM5Tyx8 :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

消费端幂等

消息体带业务流水号

DB唯一键 / Redis锁去重

生产端幂等

enable.idempotence=true

防止生产者重试导致的重复消息

消费端去重示例：

— ✅ 唯一索引保证幂等
CREATE TABLE order_event (
id BIGINT PRIMARY KEY,
order_id BIGINT NOT NULL,
event_id VARCHAR(64) UNIQUE, — 业务流水号唯一索引
event_type VARCHAR(32),
create_time DATETIME
);

// ✅ 消费时先检查是否已处理
public void consumeMessage(ConsumerRecord<String, String> record) {
String eventId = extractEventId(record.value());

// Redis 分布式锁 / DB 唯一键检查
if (eventService.isProcessed(eventId)) {
log.info("⏭️ 消息已处理，跳过。eventId: {}", eventId);
return;
}

// 业务处理 + 记录处理状态（原子操作）
orderService.processOrderMessage(record);
eventService.markProcessed(eventId);
}

六、总结 📝

🎯 Kafka 通过分区机制提供顺序保证，通过 Key 哈希实现业务级顺序路由，通过状态机校验+幂等解决乱序和重复两大难题。