Docker环境下Kafka无法连接Zookeeper求助：连接被拒绝

这个问题的核心是Docker容器的网络隔离特性导致的——你启动的两个容器默认处于不同的网络命名空间，Kafka容器里的localhost只指向它自己的内部，而不是宿主机或Zookeeper容器的地址，所以会出现连接拒绝的错误。

下面是分步的解决方案：

1. 创建共享的Docker网络 #

首先创建一个自定义网络，让Zookeeper和Kafka容器加入同一个网络，这样它们可以通过容器名互相访问：

docker network create kafka-net

2. 重新启动Zookeeper容器 #

启动Zookeeper时指定刚才创建的网络，设置容器名（方便Kafka识别），并映射端口：

docker run -d --name zookeeper --network kafka-net -p 2181:2181 zookeeper

3. 启动Kafka容器并配置正确的Zookeeper地址 #

启动Kafka时加入同一个网络，通过容器名zookeeper来指定Zookeeper的地址，同时配置Kafka的广告监听地址（确保外部能正常访问）：

docker run -d --name kafka --network kafka-net -p 9092:9092 \
  -e KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181 \
  -e KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092 \
  wurstmeister/kafka

验证连接是否成功 #

• 查看Kafka日志确认连接状态：

docker logs kafka

如果看到类似INFO Successfully submitted metrics to Kafka topic __consumer_offsets的日志，说明连接Zookeeper成功。

• 也可以在Kafka容器内测试和Zookeeper的连通性：

docker exec -it kafka ping zookeeper

如果能收到响应，说明网络连通正常。

为什么之前的启动方式不行？ #

你之前直接docker run zookeeper和docker run wurstmeister/kafka，两个容器默认使用Docker的bridge网络，但没有配置容器名和网络关联，Kafka容器里的localhost:2181指向的是自身容器的2181端口（而Kafka并没有监听这个端口），自然会连接失败。通过自定义网络+容器名的方式，Docker会自动做DNS解析，让Kafka能正确找到Zookeeper容器的地址。

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