Kafka配置文件如何正确编写

Kafka配置文件正确编写指南

一、配置文件基础信息

Kafka的核心配置文件为server.properties，默认位于安装目录的config子目录下（如/usr/local/kafka/config/server.properties或/etc/kafka/server.properties）。编写配置文件前，建议备份原始文件以防止配置错误导致服务异常。

二、Broker核心配置（必改项）

Broker配置是Kafka运行的基础，直接影响服务识别、网络通信和数据存储：

broker.id：集群中每个broker的唯一整数标识，范围建议为0~1024（避免与其他服务冲突）。若集群中有3个broker，可分别设置为0、1、2。
listeners：broker监听的网络地址和端口，格式为协议://主机名:端口。常见协议包括PLAINTEXT（明文传输，仅测试用）、SSL（加密传输）、SASL_PLAINTEXT（带认证的明文）。例如：listeners=PLAINTEXT://your.kafka.host:9092。
advertised.listeners：客户端连接broker时使用的地址，需根据客户端网络环境设置。若broker在NAT后（如云服务器），需填写公网IP或域名；若客户端与broker在同一网络，可使用内网地址。例如：advertised.listeners=PLAINTEXT://public.kafka.host:9092。
log.dirs：Kafka日志（消息数据）的存储目录，支持多个目录（逗号分隔），建议分布在不同物理磁盘以提高IO性能。例如：log.dirs=/data/kafka-logs1,/data/kafka-logs2。
zookeeper.connect：ZooKeeper集群的连接字符串，格式为主机1:端口1,主机2:端口2,.../chroot（chroot为可选的命名空间，用于隔离不同Kafka集群）。例如：zookeeper.connect=localhost:2181/kafka。

三、关键性能与可靠性配置（必调项）

这些配置决定了Kafka的性能、数据可靠性和资源利用率：

num.partitions：创建topic时的默认分区数，分区数越多并行处理能力越强，但会增加ZooKeeper负担。建议根据业务吞吐量设置（如每秒1万条消息可设置为8~16）。例如：num.partitions=8。
default.replication.factor：创建topic时的默认副本数，副本数越多数据可靠性越高，但会增加存储成本。生产环境建议设置为3（集群节点数≥3时）。例如：default.replication.factor=3。
min.insync.replicas：写入操作需确认的最小同步副本数，与producer的acks参数配合使用。例如，若设置为2，需至少2个同步副本确认才算写入成功，可保证数据不丢失。建议设置为default.replication.factor-1（如default.replication.factor=3时，设置为2）。
log.retention.hours：日志保留时间（小时），超过该时间的消息将被自动删除。可根据业务需求设置（如7天=168小时）。例如：log.retention.hours=168。
log.segment.bytes：单个日志段文件的大小（字节），当日志文件达到该大小后会创建新文件。建议设置为1GB（默认值），避免单个文件过大影响清理效率。例如：log.segment.bytes=1073741824。
num.network.threads：处理网络请求的线程数，建议设置为CPU核心数的2~4倍（如4核CPU设置为8）。例如：num.network.threads=8。
num.io.threads：处理磁盘IO的线程数，建议设置为磁盘数×2（如2块磁盘设置为4）。例如：num.io.threads=8。

四、Topic级配置（可选但重要）

Topic级配置可覆盖broker的默认配置，适用于特定topic的特殊需求：

auto.create.topics.enable：是否允许自动创建topic，生产环境建议设置为false（避免非预期的topic创建）。例如：auto.create.topics.enable=false。
retention.ms：topic级别的日志保留时间（毫秒），优先级高于broker的log.retention.hours。例如：retention.ms=604800000（7天）。
max.message.bytes：topic级别的最大消息大小（字节），避免单个大消息阻塞整个topic。例如：max.message.bytes=1048576（1MB）。
compression.type：topic级别的消息压缩类型，可选none（不压缩）、gzip、snappy、lz4、zstd（推荐zstd，压缩率高且性能好）。例如：compression.type=zstd。

五、配置文件示例

以下是一个生产环境的server.properties示例（需根据实际情况修改）：

# Broker唯一标识
broker.id=0

# 监听地址和端口
listeners=PLAINTEXT://your.kafka.host:9092

# 客户端连接地址
advertised.listeners=PLAINTEXT://public.kafka.host:9092

# 日志存储目录
log.dirs=/data/kafka-logs1,/data/kafka-logs2

# ZooKeeper连接
zookeeper.connect=localhost:2181/kafka

# 默认分区数
num.partitions=8

# 默认副本数
default.replication.factor=3

# 最小同步副本数
min.insync.replicas=2

# 日志保留时间（小时）
log.retention.hours=168

# 日志段大小（字节）
log.segment.bytes=1073741824

# 网络线程数
num.network.threads=8

# IO线程数
num.io.threads=8

# 消息最大大小（字节）
message.max.bytes=104857600

六、配置生效与验证

保存配置文件：修改完成后，使用Ctrl+O（vi/nano）保存并退出。

重启Kafka服务：使配置生效，命令如下：

# 手动启动（若未配置systemd）
/path/to/kafka/bin/kafka-server-stop.sh  # 停止现有服务
/path/to/kafka/bin/kafka-server-start.sh /path/to/kafka/config/server.properties  # 启动服务

# 若配置了systemd（推荐）
sudo systemctl restart kafka

验证配置：使用Kafka命令行工具检查broker是否正常运行：

# 查看broker列表
/path/to/kafka/bin/kafka-broker-api-versions.sh --bootstrap-server your.kafka.host:9092

# 创建测试topic并发送/消费消息
/path/to/kafka/bin/kafka-topics.sh --create --bootstrap-server your.kafka.host:9092 --replication-factor 3 --partitions 8 --topic test-topic
/path/to/kafka/bin/kafka-console-producer.sh --bootstrap-server your.kafka.host:9092 --topic test-topic
/path/to/kafka/bin/kafka-console-consumer.sh --bootstrap-server your.kafka.host:9092 --topic test-topic --from-beginning