kafka 3.3.0+默认支持无zookeeper的kraft模式，需用config/kraft/server.properties配置并执行kafka-storage.sh format初始化；旧版本或混用模式会导致启动失败。
kafka-server-start.sh 报 Failed to find any class that implements Plugin 或卡在连接 zookeeper.connect。
确认 Kafka 版本与部署模式是否匹配
先查清你下载的是不是 3.3.0 及以上版本（如 kafka_2.12-3.9.1.tgz）：解压后看目录名或运行 bin/kafka-topics.sh --version。低于 3.3.0 的版本不支持 KRaft，硬改 server.properties 去掉 zookeeper.connect 会直接启动报错。
- 用 KRaft（推荐新部署）：配置文件路径是
config/kraft/server.properties，启动脚本也必须指向它 - 用 ZooKeeper（兼容旧集群/部分云服务）：配置文件是
config/server.properties，且必须先确保 ZooKeeper 进程已运行 - 混用会失败：比如用 KRaft 配置却执行
./kafka-server-start.sh config/server.properties，日志里会出现NoClassDefFoundError: org/apache/zookeeper/ZooKeeper
配置 KRaft 模式时最易漏的三步
KRaft 不需要 ZooKeeper，但替代机制更严格——kafka-storage.sh 必须完整执行，否则 meta.properties 缺失导致 broker 拒绝启动。
- 生成集群 ID：
kafka-storage.sh random-uuid，别直接写死字符串，必须用命令输出结果 - 格式化存储目录：
kafka-storage.sh format -t <uuid> -c config/kraft/server.properties</uuid>，注意-t是 cluster ID，不是 node ID；-c后跟的是配置文件全路径 - 检查
log.dirs目录权限：chown -R $USER:$USER /opt/kafka_2.12-3.9.1/data/kafka，否则 format 会静默失败，meta.properties不生成
listeners 和 advertised.listeners 不一致的典型症状
本地测试时设成 PLAINTEXT://localhost:9092 没问题，但一旦换到云服务器或 Docker，消费者连不上、超时、报 Connection refused，八成是这两个参数没对齐。
-
listeners是 broker 实际监听的地址，可设为PLAINTEXT://0.0.0.0:9092（允许所有网卡接入） -
advertised.listeners是告诉客户端“你该连谁”，必须填外部可访问的 IP 或域名，比如PLAINTEXT://192.168.1.100:9092或PLAINTEXT://kafka.example.com:9092 - 如果只配了
listeners没配advertised.listeners，Kafka 会自动推导，但在 NAT 环境下大概率推错，务必显式声明
后台运行和 systemd 管理的坑点
直接 nohup ./kafka-server-start.sh ... & 能跑，但进程挂掉不会自动拉起，日志也不进 journalctl。用 systemd 更稳，但有两处必须手动处理：
-
ExecStart必须用绝对路径：/opt/kafka_2.12-3.9.1/bin/kafka-server-start.sh /opt/kafka_2.12-3.9.1/config/kraft/server.properties，不能用../相对路径 - 加
Environment="JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk"，否则 systemd 启动时找不到 Java，报java: command not found - 首次启动前先手动运行一次脚本，确认
log.dirs下已生成__cluster_metadata-0分区目录，否则 systemd 会因目录为空反复重启
meta.properties 文件一旦生成就不可更改 cluster.id，重装必须删干净 log.dirs 全目录再 format —— 这个限制容易被忽略，导致反复启动失败。
