Windows Docker Desktop下无法连接Kafka Broker报错问题排查

问题表现 #

• 部署环境：Windows系统运行最新版Docker Desktop，使用Confluent官方标准docker-compose配置部署Kafka集群
• 端口连通性验证：执行端口测试命令Test-NetConnection localhost -port 9092，返回结果如下，确认端口连通正常：

TcpTestSucceeded : True

• 客户端连接报错：使用标准Python Kafka测试客户端连接时抛出如下传输错误：

KafkaError{code=_TRANSPORT,val=-195,str="Failed to get metadata: Local: Broker transport failure"}

• 前期排查情况：已对照官方Kafka客户端连接排查指南核对所有配置项，未发现配置错误，符合指南中「配置全部正确但无法连接」的典型场景。

根因定位与解决方案 #

重新梳理全链路排查步骤后，最终定位问题根源为：Kafka Broker配置的localhost监听器对应端口被主机上其他进程占用，导致Broker实际未成功绑定对应端口。
解决方案：修改docker-compose配置中Kafka Broker暴露的监听器端口为未被占用的空闲端口，重新启动容器集群后，客户端即可正常连接。

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