Kafka发送至带UUID主题报LEADER_NOT_AVAILABLE错误排查

看起来你遇到的问题是短主题名能正常生产数据，但带长UUID后缀的主题名触发了LEADER_NOT_AVAILABLE错误，这通常和主题创建过程、集群元数据同步或主题自身状态有关。下面是几个排查和解决的具体方向：

1. 先手动创建主题，排除自动创建的隐性问题 #

很多时候自动创建主题会因为元数据同步延迟、配置限制等隐性原因失败。你可以先用Kafka命令行工具手动创建这个长主题，验证是否能成功：

kafka-topics.sh --create --topic my-11111111-1111-1111-1111-111111111111-topic --bootstrap-server localhost:9092 --partitions 1 --replication-factor 1

如果创建命令返回错误，会直接提示问题根源（比如权限不足、名称规则冲突等）；如果创建成功，再尝试发送数据，大概率能解决问题——毕竟短主题能正常工作，说明生产者与Broker的连接本身是没问题的。

2. 确认自动创建主题的配置是否生效 #

如果你依赖Kafka的自动主题创建功能，要确保Broker配置里的auto.create.topics.enable参数设为true（默认是开启状态，但可能被修改过）。即使开启了该配置，自动创建新主题时也可能因为元数据同步较慢，导致生产者暂时获取不到Leader信息。这时候可以在生产者配置里缩短metadata.max.age.ms（默认5分钟），让生产者更快刷新元数据，获取新主题的状态。

3. 检查主题的分区Leader状态 #

不管是自动还是手动创建主题，都可以用以下命令查看主题的详细状态：

kafka-topics.sh --describe --topic my-11111111-1111-1111-1111-111111111111-topic --bootstrap-server localhost:9092

重点关注输出中的Leader字段：如果显示为none，说明该分区没有选举出可用的Leader。这种情况下，要检查Broker是否正常运行、磁盘是否有读写权限；如果是多节点集群，还要确认集群间的元数据同步是否正常。单节点集群的Leader应该显示为你的Broker ID（通常是0），如果异常，尝试重启Broker即可。

4. 关于Listener配置的补充验证 #

你已经设置了listeners=PLAINTEXT://:9092和advertised.listeners=PLAINTEXT://localhost:9092，这个配置在本地测试场景是合理的，但要确保生产者的bootstrap.servers配置的是localhost:9092，与Broker的advertised.listeners地址完全一致——如果生产者连接的是其他地址，可能会导致元数据获取异常。

内容的提问来源于stack exchange，提问作者Kiril Mytsykov