部署HBase时启动HMaster遇IllegalStateException：hsync异常求助

我来帮你一步步排查这个HMaster启动时的hsync异常问题——既然你已经确认ZooKeeper分布式集群、RegionServer都正常，那问题大概率出在HBase和Hadoop 3.x的兼容性配置上，毕竟你用的是HBase 2.0.0 beta1这个早期测试版本，和Hadoop 3.0.0的适配本身就有不少坑。

1. 调整HBase的hsync相关核心配置 #

首先修改conf/hbase-site.xml，针对Hadoop 3.x的DFS同步机制做适配：

• 关闭WAL的强制hsync同步：

  <property>
    <name>hbase.regionserver.wal.hsync</name>
    <value>false</value>
  </property>
  <property>
    <name>hbase.wal.hsync</name>
    <value>false</value>
  </property>
  

  这是因为Hadoop 3.x对DFS的sync逻辑做了优化，而HBase 2.0 beta版本默认开启的hsync会触发兼容性异常，改用异步刷写可以规避这个问题。

• 同时检查hbase.rootdir的权限：
  确保HBase对HDFS上的根目录有读写权限，执行命令：

  hdfs dfs -chown hbase:hbase /hbase
  

2. 修复Hadoop客户端jar包版本冲突 #

HBase依赖Hadoop的HDFS客户端，你需要确认HBase lib目录下的Hadoop相关jar包和集群的Hadoop 3.0.0版本完全一致。如果HBase自带的是Hadoop 2.x的jar包，直接替换成Hadoop 3.0.0对应的hadoop-common-3.0.0.jar、hadoop-hdfs-3.0.0.jar等核心jar包，避免版本不匹配导致的IO异常。

3. 调整HMaster的JVM启动参数 #

编辑conf/hbase-env.sh，添加关键的兼容性参数：

export HBASE_MASTER_OPTS="-Xmx4G -XX:+UseG1GC -Dhbase.unsafe.stream.capability.enforce=false"

这里的-Dhbase.unsafe.stream.capability.enforce=false是核心——它会禁用HBase对HDFS流能力的严格检查，而Hadoop 3.x的流实现和HBase 2.0 beta版本的检查逻辑不兼容，开启这个参数就能绕过hsync相关的报错。

4. 彻底清理残留数据（别只清ZK） #

除了你已经做的清理ZooKeeper上的HBase节点（用zkCli.sh执行rmr /hbase），还要清理HDFS上的HBase根目录：

hdfs dfs -rm -r /hbase

之后再重新启动HBase，让它重新初始化元数据。

5. 升级到HBase稳定版（终极建议） #

你用的HBase 2.0.0 beta1是早期测试版本，本身存在很多未修复的bug，对Hadoop 3.x的适配也不完善。建议直接升级到HBase 2.0.x的稳定版（比如2.0.6），这个版本已经修复了大量和Hadoop 3.x兼容的问题，大概率能直接解决你的hsync异常。

如果以上步骤都没解决，建议把HMaster日志中hsync异常的完整栈信息贴出来，比如找到类似java.io.IOException: hsync failed的异常，看具体是哪个类抛出的，这样能更精准定位问题。

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