错误1：外网访问异常，日志出现“advertised.listeners cannot use the nonroutable meta-address 0.0.0.0”。原因：advertised.listeners 不能是 0.0.0.0，它会被注册到 Zookeeper 供客户端连接，必须是可路由的 IP/域名。解决：在 server.properties 中设置如 advertised.listeners=PLAINTEXT://<内网或公网IP>:9092，并确保与 listeners 一致或按需区分内外网监听。
错误2：客户端连接超时或“Broker may not be available”。原因：客户端拿到的连接地址不可达（如仅配了内网地址、端口不通、防火墙未放行）。解决：核对 listeners/advertised.listeners 是否为客户端可达地址；在服务器放行端口（如 9092/2181）；用 telnet <broker_ip> 9092 或 nc 验证连通性。
错误2：Topic 分区数过小导致发送失败。现象：Invalid partition given with record: X is not in the range [0…N)。解决：增加分区数，例如：
kafka-topics.sh --alter --topic --partitions --bootstrap-server broker:9092。
错误3：Topic 不存在或客户端报 “this server does not host this topic-partition”。解决：先创建 Topic（指定合适的 –partitions 与 –replication-factor），或确认客户端 bootstrap.servers 指向包含该分区 Leader 的 Broker。
四 安全认证与权限
错误1：SASL/GSSAPI（Kerberos）启动失败，提示 “Conflicting serviceName values found in JAAS and Kafka configs”。原因：JAAS 文件中的 serviceName 与 Kafka 配置不一致。解决：统一为 serviceName=kafka（KafkaServer/KafkaClient 段），不要写成 “zookeeper”；同时确保 principal 与 keyTab 路径正确且可读。