消息队列 / 系统课时
配置最小同步副本
配置最小同步副本
本课解决“副本仍存在,但生产请求为什么会被拒绝”的问题。你将把 min.insync.replicas、当前 ISR 和生产者 acks=all 放到同一条写入链路中验证,明确 3 副本场景在 ISR 从 3 降到 2、再降到 1 时的真实写入边界。
学习目标
- 理解
min.insync.replicas约束的是当前 ISR,而不是 Topic 的总副本数 - 解释
acks=all与最小同步副本门槛如何共同决定写入是否成功 - 能配置 Topic 级最小同步副本,并通过配置、ISR 和生产请求完成验证
把写入门槛放回整条链路
min.insync.replicas 定义的是:当生产者使用 acks=all(等价于 acks=-1)时,Leader 接受写入所要求的最小 ISR 数量。它不等于 replication.factor,也不会强制所有配置副本一直在线;真正参与门槛判断的是该分区当时的 ISR。
acks=all 要求 Leader 按 ISR 的同步状态完成确认;min.insync.replicas 则规定 ISR 至少要有多少成员,写入才允许继续。因此,3 副本、min.insync.replicas=2 时,只剩 1 个 ISR 会失败,原因是 ISR 数量小于最小同步副本数,而不是 acks=all 自身固定要求“至少 2 个副本”。
用三副本场景看清边界
假设 replication.factor=3、min.insync.replicas=2、生产者 acks=all,写入边界如下。
| 当前 ISR 数量 | 写入结果 | 原因 |
|---|---|---|
| 3 | 可写 | ISR 满足最小同步副本门槛 |
| 2 | 可写 | 仍满足 min.insync.replicas=2 |
| 1 | 拒绝写入 | ISR 少于 min.insync.replicas |
这组配置表达的不是“永远保证 3 个副本在线”,而是“允许 1 个副本退出 ISR 后继续写,但不允许 ISR 缩到 1 时仍以 acks=all 写入”。

配置并核对 Topic
下面以 Topic 级动态配置为例,将最小同步副本设置为 2,并同时查看配置和分区 ISR。命令中的 <PATH>、<HOST>、<PORT>、<TOPIC> 按实际环境替换。
<PATH>/bin/kafka-configs.sh \
--bootstrap-server <HOST>:<PORT> \
--entity-type topics \
--entity-name <TOPIC> \
--alter \
--add-config min.insync.replicas=2 >/dev/null
<PATH>/bin/kafka-configs.sh \
--bootstrap-server <HOST>:<PORT> \
--entity-type topics \
--entity-name <TOPIC> \
--describe | grep -o 'min.insync.replicas=2'
<PATH>/bin/kafka-topics.sh \
--bootstrap-server <HOST>:<PORT> \
--describe \
--topic <TOPIC>预期结果(仅列关键字段)
min.insync.replicas=2
Topic: <TOPIC> Partition: <ID> Leader: <ID> Replicas: <ID>,<ID>,<ID> Isr: <ID>,<ID>,<ID>第一行确认 Topic 级配置已经保存;Replicas 用于确认配置副本集合,Isr 用于确认当前同步副本集合。Broker ID、分区编号和其他字段因环境而异。如果 Replicas 有 3 个成员而 Isr 只有 2 个,说明已经有一个副本退出 ISR,但此时仍满足 min.insync.replicas=2。
验证故障时的写入边界
要完成闭环,不能只看到参数值,还要确认故障发生后 ISR 是否真的下降,以及 acks=all 的生产请求是否按门槛被拒绝。先通过计划内停掉一个 Follower、隔离其网络或制造足够复制延迟,让目标分区的 ISR 从 3 降到 2;再次执行上一节的 kafka-topics.sh --describe,应看到 Isr 只剩 2 个 Broker,此时写入仍可继续。
如果再让另一个 Follower 退出 ISR,使该分区在发起请求前已经稳定处于 ISR=1,使用同步发送的控制台生产者验证拒绝行为:
printf 'min-isr-check\n' | <PATH>/bin/kafka-console-producer.sh \
--bootstrap-server <HOST>:<PORT> \
--topic <TOPIC> \
--sync \
--producer-property acks=all \
--producer-property retries=0 \
--producer-property request.timeout.ms=5000 \
--producer-property delivery.timeout.ms=10000预期结果(错误类型)
org.apache.kafka.common.errors.NotEnoughReplicasException当请求到达 Leader 时 ISR 已少于 2,Broker 会以“同步副本不足”拒绝写入,客户端错误中应能看到 NotEnoughReplicasException;若 ISR 是在写入已经开始后才继续缩小,部分时机会表现为 NotEnoughReplicasAfterAppendException。两者都说明失败来自 ISR 无法满足 min.insync.replicas,不是 acks=all 单独规定了“至少两个副本”。
把参数组合成治理门禁
可靠性判断至少同时回答三件事:分区配置了多少副本、当前 ISR 有多少、生产者是否使用 acks=all。只看其中一个参数,无法判断一次写入到底具备怎样的副本保护。
对于 3 副本、min.insync.replicas=2、acks=all 的常见组合,ISR=3 是健康状态,ISR=2 是可继续写入但冗余已经下降的状态,ISR=1 则应接受写入失败并优先修复副本健康。unclean.leader.election.enable 解决的是“没有 ISR Leader 候选时能否让非 ISR 副本接管”的问题,与最小 ISR 的写入门槛不同,不应把二者当成同一个可靠性开关。