Docker部署Kafka后本地Spring Producer无法解析主机问题求助

问题根源 #

Kafka在Docker容器中运行时，默认会将容器ID作为advertised.listeners的主机名返回给客户端。当本地Spring Producer通过localhost:9092完成初始连接后，Broker会把这个容器ID地址告知Producer，Producer后续尝试用该地址通信时，因本地DNS无法解析容器ID，就会抛出UnknownHostException。

解决方案1：修改Kafka容器的advertised.listeners配置 #

这是最持久的解决方法，让Kafka对外暴露本地可直接解析的地址：

1. 先确保ZooKeeper容器已启动（假设容器名为zookeeper），然后启动Kafka容器时添加以下环境变量：

   docker run -d \
     --name kafka \
     -p 9092:9092 \
     -e KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181 \
     -e KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092 \
     -e KAFKA_LISTENERS=PLAINTEXT://0.0.0.0:9092 \
     --link zookeeper \
     ubuntu/kafka
   

2. 重启Kafka容器后，你的Spring Producer现有配置spring.kafka.producer.bootstrap-servers=localhost:9092无需修改，即可正常与Kafka通信。

解决方案2：临时映射容器ID到localhost #

如果不想重新配置Kafka容器，可以通过本地hosts文件做临时映射：

• Windows系统：打开C:\Windows\System32\drivers\etc\hosts（需管理员权限），添加一行：127.0.0.1 2dd34aa10a8e（替换为你的Kafka容器ID）
• WSL2系统：打开/etc/hosts，添加同样的映射行
• 保存文件后，Spring Producer就能解析容器ID对应的地址。注意：容器重启后ID会变化，需要重新修改hosts文件。

额外检查项 #

• 确认Docker Desktop的WSL2集成已开启，Kafka容器的9092端口已正确映射到本地（docker ps可查看端口映射情况）
• 验证ZooKeeper与Kafka容器之间的网络连通性，确保Kafka能正常连接ZooKeeper

内容的提问来源于stack exchange，提问作者Farfetch'd