连接独立版HBase时出现No meta znode available错误

问题描述 #

尝试使用Java API连接独立版HBase实例，已成功连接并创建test_table表，但仍抛出如下错误：

21:58:06.527 [ReadOnlyZKClient-192.168.142.129:2181@0x7bb58ca3-SendThread(192.168.142.129:2181)] DEBUG org.apache.zookeeper.ClientCnxn - Got ping response for sessionid: 0x192b47ed5110005 after 1ms
21:58:13.231 [ReadOnlyZKClient-192.168.142.129:2181@0x7bb58ca3-SendThread(192.168.142.129:2181)] DEBUG org.apache.zookeeper.ClientCnxn - Reading reply sessionid:0x192b47ed5110005, packet:: clientPath:/hbase serverPath:/hbase finished:false header:: 47,8 replyHeader:: 47,105,0 request:: '/hbase,F response:: v{'running,'rs,'splitWAL,'backup-masters,'flush-table-proc,'draining,'master-maintenance,'online-snapshot,'hbaseid,'table,'switch,'master}
21:58:13.232 [main] DEBUG org.apache.hadoop.hbase.client.RpcRetryingCallerImpl - Call exception, tries=13, retries=16, started=88564 ms ago, cancelled=false, msg=No meta znode available, details=row 'test_table' on table 'hbase:meta' at null, exception=java.io.IOException: No meta znode available
at org.apache.hadoop.hbase.client.ZKConnectionRegistry.getMetaRegionLocation(ZKConnectionRegistry.java:144)
...

使用的连接代码 #

public static void main(String[] args) throws IOException {

    Configuration config = HBaseConfiguration.create();

    config.set("hbase.defaults.for.version.skip", "true");

    config.set("hbase.zookeeper.quorum", "192.168.142.129");
    config.set("hbase.zookeeper.property.clientPort", "2181");
    config.set("hbase.master", "192.168.142.129:60010"); // HBase Master address

    try (Connection connection = ConnectionFactory.createConnection(config);
         Admin admin = connection.getAdmin()) {

        TableName tableName = TableName.valueOf("test_table");
        String columnFamily = "cf";

        if (!admin.tableExists(tableName)) {
            HTableDescriptor tableDescriptor = new HTableDescriptor(tableName);
            tableDescriptor.addFamily(new HColumnDescriptor(columnFamily));
            admin.createTable(tableDescriptor);
            System.out.println("Table created successfully.");
        } else {
            System.out.println("Table already exists.");
        }

}

可能的原因及排查方向 #

• ZooKeeper元数据节点未注册：HBase的hbase:meta表信息需注册到ZK的/hbase/meta-region-server节点。登录ZK客户端执行ls /hbase，检查该节点是否存在；若不存在，说明RegionServer未完成元数据注册，需检查RegionServer运行状态。
• 版本不兼容：代码中hbase.defaults.for.version.skip=true跳过了版本检查，可能导致客户端与服务端版本不匹配。建议移除该配置，确保客户端依赖的HBase版本与服务端完全一致。
• 超时配置不足：日志显示请求重试13次仍失败，可能是网络延迟或超时时间过短。可添加以下配置延长超时：

  config.set("hbase.client.retries.number", "20");
  config.set("hbase.rpc.timeout", "60000");
  config.set("hbase.client.operation.timeout", "60000");
  

• HBase服务端异常：表创建成功但元数据同步延迟，检查Master和RegionServer的日志，确认是否有元数据相关报错；尝试重启HBase服务（先停RegionServer，再停Master，最后反向启动）。
• 手动配置错误：hbase.master地址可能有误，或客户端配置与服务端hbase-site.xml不一致。建议直接将服务端的hbase-site.xml放入客户端项目的classpath，避免手动配置出错。

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