多线程并发消费时保证局部业务顺序性的核心是相同业务标识消息由同一线程顺序处理；需生产者用业务key绑定分区，消费者端采用单Consumer+多Worker+Key分发队列模型，并手动控制位点提交与重平衡处理。
多线程并发消费时保证局部业务顺序性，核心是“相同业务标识的消息必须由同一线程顺序处理”，而不是简单地让多个线程抢着消费消息。Kafka 本身只保证分区内有序，但消费者端若用多线程直接处理拉取到的消息，极易打乱顺序。关键在于把“分区有序”延续到“业务逻辑执行有序”。
生产者端：用业务 Key 绑定分区
这是整个链条的起点，必须确保同一业务实体（如订单 ID、用户 ID）的所有消息进入同一个分区：
- 发送消息时显式指定 key，例如
new ProducerRecord<>("topic", "ORD-1001", value) - Kafka 默认使用
hash(key) % partitionCount路由，只要分区数不变，相同 key 必进同一分区 - 禁用异步重试干扰顺序：
max.in.flight.requests.per.connection=1+retries=0+acks=all
消费者端：单 Consumer 实例 + 多 Worker 线程 + Key 分发队列
不共享 KafkaConsumer 实例，也不让多个线程直接操作 poll() 返回的 records。推荐模型是：
- 主线程用单个
KafkaConsumer拉取消息（poll()），按消息 key 做哈希取模，分发到对应阻塞队列中 - 每个 worker 线程独占一个队列（如
BlockingQueue<ConsumerRecord>），只从自己的队列取、处理、提交位点 - 例如：3 个 worker 线程 → 3 个队列 → key % 3 决定路由，保证相同 key 永远进同一队列、被同一线程串行处理
位点提交：手动控制，避免错位或重复
不能依赖自动提交，也不能让多个线程各自提交 offset，否则可能跳过消息或重复消费：
立即学习“Java免费学习笔记（深入）”；
- 关闭
enable.auto.commit=true - 每个 worker 线程在成功处理完一条消息后，记录该消息的 offset（如存入线程本地 map）
- 采用“批次级提交”：当某一分区下所有已分发到各队列的消息都处理完毕，再统一提交该分区的最高 offset
- 或用全局计数器 + 分区粒度位点缓存，确保提交前该分区无遗漏
应对重平衡：消费前校验分区归属
Rebalance 可能导致分区被分配给其他消费者，而当前 consumer 还在处理旧分区消息，造成跨消费者乱序：
- 实现
ConsumerRebalanceListener，在onPartitionsRevoked中暂停对应队列的消费，并等待正在处理的消息完成 - 在
onPartitionsAssigned中清空或跳过已失效队列中的残留消息（或标记为待丢弃） - 可结合
pause()/resume()控制拉取节奏，避免新分配前继续 poll 出旧分区消息
