最小同步副本是什么
min.insync.replicas 定义了「写入至少要落到几个副本才算成功」的下限，只在生产者使用 acks=all 时生效。当分区的 ISR（与 leader 保持同步的副本集合）数量低于这个值，broker 会直接拒绝写入并抛 NotEnoughReplicas 异常。它是用可用性换一致性的开关：宁可写不进去，也不让只有 leader 收到的消息被当作已提交——因为 leader 一旦故障，那条消息就可能永久丢失。
基本信息
| 作用位置 | Broker 默认值与主题级配置，作用于 acks=all 的写入 |
|---|---|
| 典型设置 | 副本因子 3 配 min.insync.replicas=2 |
| 失败表现 | NotEnoughReplicasException，消息未写入 |
| 前提条件 | 生产者必须使用 acks=all，acks=1 下该参数不生效 |
| 可配置层级 | broker 默认与 topic 级，分区级也可覆盖 |
| 相关概念 | ISR 收缩、URP（副本落后）指标 |
设置与验证
设置与验证
kafka-configs.sh --bootstrap-server localhost:9092 \
--entity-type topics --entity-name orders --alter \
--add-config min.insync.replicas=2
# 查看生效值（不含默认值则需要加 --describe 并对照 broker 默认）
kafka-configs.sh --bootstrap-server localhost:9092 \
--entity-type topics --entity-name orders --describe
# 查看分区 ISR 现状
kafka-topics.sh --bootstrap-server localhost:9092 --describe --topic orders典型使用场景
- 交易与订单类主题：必须保证已确认的消息不会因 leader 故障而丢失
- 故障演练：下线一个 broker 观察写入是否按预期拒绝而非静默降级
- 指标告警：把 ISR 收缩与写入失败关联起来，提前发现副本同步落后
- 容量评估：副本落后导致写入被拒时，需要判断是磁盘、网络还是负载问题
- 主题分级：不同重要程度的主题按不同冗余要求分别设置
参数组合对照
| 组合 | 容错能力 | 写入行为 |
|---|---|---|
| acks=all + min.insync.replicas=2 + 副本 3 | 容忍 1 个副本故障 | ISR 降到 1 时拒绝写入 |
| acks=all + min.insync.replicas=1 + 副本 3 | 可用性高但一致性弱 | 只要 leader 在就能写入 |
| acks=1 + 任意配置 | leader 故障可能丢消息 | 该参数不起作用 |
| min.insync.replicas 大于副本因子 | 永远不可写 | 持续抛出异常 |
设置值大于副本数会导致该主题一直不可写；调整副本因子后要同步核对这个参数。
写入被拒不是故障的全部：它说明集群副本同步已经跟不上，需要同时看磁盘、网络与 broker 负载，否则去掉限制只是把风险换成静默丢消息。