Docker部署Kafka连接ZooKeeper超时问题求助

检查容器网络配置 #

• 确保Kafka和ZooKeeper容器处于同一个Docker网络。可以在docker-compose.yml中显式定义自定义网络，避免默认bridge网络的解析问题：

  version: '3'
  networks:
    kafka-internal:
      driver: bridge
  services:
    zookeeper:
      image: zookeeper:3.8
      networks:
        - kafka-internal
      ports:
        - "2181:2181"
    kafka:
      image: wurstmeister/kafka:latest
      networks:
        - kafka-internal
      ports:
        - "9092:9092"
      environment:
        KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
        KAFKA_ADVERTISED_HOST_NAME: localhost
  

• 重点确认Kafka的KAFKA_ZOOKEEPER_CONNECT参数使用ZooKeeper的服务名（如上述的zookeeper:2181），而非localhost或主机IP——容器内部无法通过localhost访问其他容器。

调整ZK连接超时参数 #

默认会话超时可能不足以等待ZK完成初始化，可在Kafka的环境变量中延长超时时间：

KAFKA_ZOOKEEPER_SESSION_TIMEOUT_MS: 30000
KAFKA_ZOOKEEPER_CONNECTION_TIMEOUT_MS: 15000

手动验证ZK连通性 #

• 先单独启动ZooKeeper容器，待其完全就绪后，进入Kafka容器内部测试连接：

  docker exec -it <kafka-container-id> bash
  

• 在容器内用ZK客户端工具测试：

  /opt/kafka/bin/zookeeper-shell.sh zookeeper:2181
  

  若能进入ZK交互提示符，说明网络和ZK服务正常；若连接失败，优先排查网络配置。

检查主机防火墙限制 #

Debian主机的ufw防火墙可能阻断容器间通信，可临时关闭防火墙测试：

sudo ufw disable

若问题解决，再添加允许Docker内部网络通信的规则：

sudo ufw allow in on docker0
sudo ufw allow out on docker0

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