Apache Kafka Broker突发连接异常：运行一年后为何需修改配置？

Kafka advertised.host.name 的核心作用 #

Kafka的advertised.host.name（新版本推荐用advertised.listeners）是用来告知客户端实际用于连接Broker的地址。当客户端请求元数据时，Kafka会把这个地址返回给客户端，后续客户端会用这个地址和Broker通信，而非初始发起连接的地址。

如果未显式配置该参数，Kafka会默认使用系统主机名对应的IP作为返回地址。

此前正常运行的原因 #

在安装WSL2之前，Windows系统的主机名解析（执行hostname命令返回的名称）默认指向127.0.0.1或localhost。此时Kafka返回给客户端的地址是本地应用（Spring/Python）可正常访问的，因此通信无异常。

WSL2安装引发的网络变化 #

WSL2会在Windows中创建独立的虚拟网卡（通常标记为WSL），并可能修改以下网络配置：

• 主机名解析规则：部分场景下，WSL2会调整Windows的hosts文件或DNS解析优先级，导致Windows主机名不再解析到127.0.0.1，而是指向WSL虚拟网络的内部IP（如172.x.x.x或192.168.x.x）。
• 网卡优先级/路由规则：WSL虚拟网卡的优先级可能被设为更高，导致Kafka默认返回的IP变为WSL虚拟网卡地址，而非本地回环地址。

当Kafka把这个WSL虚拟IP返回给客户端时，Windows本地的Spring/Python应用无法正常访问该地址（可能是防火墙拦截、路由限制或该IP仅在WSL内部可达），从而触发两类错误：

• Python端的「No broker metadata found in MetadataResponse -- ignoring.」：客户端无法连接到Kafka返回的地址，无法获取元数据。
• Java端的「LEADER_NOT_AVAILABLE」：客户端无法与Leader Broker建立连接，无法获取分区Leader信息。

配置advertised.host.name=localhost生效的原因 #

显式设置该参数后，Kafka会强制返回localhost作为客户端连接地址，客户端解析到127.0.0.1（本地回环地址），可直接与Windows本地运行的Kafka Broker通信，因此恢复正常。

额外建议 #

• 对于Kafka 2.0.0及以上版本，更推荐使用advertised.listeners配置（例如advertised.listeners=PLAINTEXT://localhost:9092），它比advertised.host.name更灵活，能明确指定协议与地址。
• 可检查Windows的hosts文件（路径C:\Windows\System32\drivers\etc\hosts），确认主机名对应的IP是否被WSL2修改，若存在指向WSL虚拟IP的条目，可调整回127.0.0.1。

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