本地Tomcat连接Docker内嵌ZooKeeper的HBase时出现重复调用异常

嘿，这个问题我之前帮人排查过好几次，本质上是Docker容器的网络配置和HBase/ZooKeeper的地址绑定逻辑没匹配上导致的。咱们一步步拆解问题、解决问题：

先搞懂为什么docker-compose里没问题，单独运行就炸？ #

docker-compose默认会给所有服务创建一个专属的内部网络，容器之间可以直接用服务名（比如hbase）互相访问，而且HBase启动时会自动适配容器内的主机名，注册到ZK里的地址在这个内部网络里是通的。但单独运行HBase容器时，本地Tomcat应用在宿主机网络，和容器不在同一个网络域，自然拿不到正确的访问地址。

解决方案分四步走： #

1. 运行HBase容器时做好端口映射

启动容器时必须把HBase和ZK的关键端口映射到宿主机，不然本地根本连不上。执行类似这样的命令：

docker run -d \
  -p 2181:2181 \
  -p 16000:16000 \
  -p 16010:16010 \
  -p 16020:16020 \
  -p 16030:16030 \
  --name hbase \
  your-hbase-image-name

• 2181：ZooKeeper客户端端口
• 16000：HMaster RPC端口
• 16010：HMaster UI端口（可选，用来验证服务是否启动）
• 16020：HRegionServer RPC端口
• 16030：HRegionServer信息端口

2. 修改HBase配置，让注册地址对本地可见

这是核心！HBase默认会把容器内部的主机名注册到ZK，本地应用拿到这个地址根本解析不了。得强制让它用宿主机的IP注册：

1. 进入HBase容器：

   docker exec -it hbase bash
   

2. 找到HBase配置文件（一般在/opt/hbase/conf/hbase-site.xml，根据你的镜像路径调整），编辑并添加/修改以下配置：

   <property>
     <name>hbase.zookeeper.quorum</name>
     <value>你的宿主机IP</value> <!-- 比如192.168.1.100，别用localhost！ -->
   </property>
   <property>
     <name>hbase.master</name>
     <value>你的宿主机IP:16000</value>
   </property>
   <property>
     <name>hbase.regionserver.hostname</name>
     <value>你的宿主机IP</value>
   </property>
   <property>
     <name>hbase.zookeeper.property.clientPort</name>
     <value>2181</value>
   </property>
   

3. 重启HBase容器生效：

   docker restart hbase
   

3. 调整本地Tomcat应用的HBase配置

把应用里的hbase-site.xml（或者代码里的配置参数）中，hbase.zookeeper.quorum的值改成你刚才填的宿主机IP，千万别填localhost或者容器名。

4. 验证连接是否正常

• 先测试ZK连接：在本地执行zkCli.sh -server 你的宿主机IP:2181，如果能进入ZK命令行，且能看到/hbase节点，说明ZK没问题。
• 再测试HBase连接：执行hbase shell -Dhbase.zookeeper.quorum=你的宿主机IP，如果能成功列出表，说明HBase服务正常。

额外注意点 #

• 如果是Windows/Mac用Docker Desktop，不用找宿主机IP，直接用host.docker.internal代替IP即可，这个地址会自动映射到宿主机。
• 检查宿主机防火墙是否开放了上述端口，避免被拦截。
• 不要用--net host（主机网络模式）快速解决，虽然能通，但会破坏容器的隔离性，生产环境不推荐。

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