| 维度 | 关键配置 | 推荐或常用值 | 作用说明 |
|---|---|---|---|
| Broker | log.dirs | 例如:/data/kafka-logs | 指定日志落地目录,确保磁盘持久化与容量规划 |
| Broker | replication.factor | ≥3 | 提升容错能力,降低单点故障风险 |
| Broker | min.insync.replicas | 2(配合 acks=all) | 写成功所需的最小 ISR 副本数 |
| Broker | log.retention.hours / log.retention.bytes | 168 小时 / 按磁盘规划 | 基于时间/大小的日志保留策略 |
| Broker | log.segment.bytes | 1GB | 日志段大小,影响滚动与清理 |
| Producer | acks | all | 仅在 ISR 全部确认后才返回成功 |
| Producer | retries | >0(如 3) | 可恢复错误的自动重试 |
| Producer | enable.idempotence | true | 幂等生产者,避免重试导致的重复 |
| Producer | transactional.id | 业务唯一标识 | 启用事务,实现跨分区/多消息的原子性 |
| Consumer | enable.auto.commit | false | 关闭自动提交,处理完成后再提交 offset |
| Consumer | auto.offset.reset | earliest | 无位移时从头消费(按需选择) |