WSL部署Kafka后Windows端Spring应用报Broker may not be available错误如何解决

问题核心原因 #

WSL2默认采用NAT网络架构，WSL实例内部的localhost与Windows宿主机的localhost不属于同一个网络命名空间。你当前配置中advertised.listeners设为localhost:9092，会导致Windows侧的Spring客户端拿到Kafka Broker的广播地址后，尝试访问Windows本地的9092端口，而非WSL实例内运行的Kafka服务，最终出现连接失败报错。

修复步骤 #

1. 首先获取WSL实例的内网IP，在WSL终端执行以下命令：

ip addr show eth0 | grep 'inet ' | awk '{print $2}' | cut -d/ -f1

输出结果即为WSL当前的内网IP，格式一般为172.28.xxx.xxx。

2. 修改Kafka的server.properties配置，调整advertised.listeners参数值为你获取到的WSL内网IP：

listeners=PLAINTEXT://0.0.0.0:9092
# 将下方IP替换为你自己WSL实例的实际IP
advertised.listeners=PLAINTEXT://172.28.xxx.xxx:9092

3. 重启Confluent本地服务让配置生效：

confluent local services stop && confluent local services start

4. 同步修改Spring应用中Kafka的连接地址，将原来的localhost:9092替换为上述WSL内网IP即可。

可选优化 #

WSL实例默认重启后IP会自动变更，你可以配置Windows端口代理规则，将WSL的9092端口映射到Windows本地端口，避免每次修改IP：
在Windows管理员权限的CMD或PowerShell中执行以下命令：

netsh interface portproxy add v4tov4 listenport=9092 listenaddress=0.0.0.0 connectport=9092 connectaddress=替换为WSL实际IP

配置完成后Spring应用仍可使用localhost:9092连接Kafka。

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