机架感知与就近读取是什么
机架感知让 Kafka 知道每个 Broker 位于哪个机架或可用区：配置 broker.rack 后，新主题的副本会尽量分散到不同机架，单机架故障不会导致分区不可用。消费侧则可通过 client.rack 配合副本选择器，让消费者优先从同机架副本拉取数据，把跨区流量与延迟降下来。注意这两件事分属不同配置：Broker 侧的 rack 影响副本分配，客户端侧的 rack 影响从哪个副本读。
基本信息
| Broker 侧 | broker.rack=<机架或可用区标识>，影响副本分配与容灾 |
|---|---|
| 消费侧 | client.rack 配合副本选择器，用于从就近副本读取 |
| 副本选择器 | 需显式指定使用机架感知的实现类，否则仍可能读主副本 |
| 生效范围 | 副本分散只影响新创建的主题；存量主题需重新分配 |
| 相关配置 | min.insync.replicas 与 acks 共同决定写入可靠性 |
| 标识一致性 | 所有节点必须使用同一套 rack 标识命名规则 |
典型使用场景
- 跨可用区集群：副本分散到不同 AZ，单区故障时仍可读写
- 跨区流量优化：同区消费者就近读取，降低跨区带宽费用与延迟
- 容灾演练：验证单机架失效后分区仍可正常选举与读写
- 新集群规划：上线时就配置 rack，避免后期重新分配存量数据
- 成本核算：核对跨区流量来源，评估就近读取的收益
配置片段
配置片段
# broker.properties：每个 Broker 按所在机架或可用区填写
broker.rack=az-a
# consumer.properties：声明消费者所在机架，并使用机架感知的副本选择器
client.rack=az-a
replica.selector.class=org.apache.kafka.common.replica.RackAwareReplicaSelector核对副本分布
核对副本分布
# 查看分区副本分布，确认没有集中在同一机架
kafka-topics.sh --bootstrap-server localhost:9092 \
--describe --topic prod.order.created.v1
# Replicas 列中同一机架的副本过多说明分布不均
# 查看未同步副本，机架故障后这里会列出受影响分区
kafka-topics.sh --bootstrap-server localhost:9092 --describe --under-replicated-partitions两类配置对照
| 配置位置 | 参数 | 作用 |
|---|---|---|
| Broker | broker.rack | 副本分散到不同机架，提升容灾能力 |
| 客户端 | client.rack | 声明消费者所在机架，供副本选择器使用 |
| 客户端 | 副本选择器类 | 启用机架感知读取，否则不生效 |
| Broker | min.insync.replicas | 与 acks 配合决定写入的可靠性下限 |
机架感知只影响新建主题的副本分配；存量主题必须显式执行分区重分配才会按新拓扑排布，否则配置了 rack 也不会自动迁移。
扩容或搬迁后若 rack 标识填写不一致或漏填，副本分布可能重新聚集到同一机架，容灾能力在无声中下降；节点变更后应复核副本分布。