HBase0.9x作为经典的分布式列式数据库版本，在不少老项目和新手学习场景中仍有使用，实际部署和运行过程中容易出现各类问题，本文针对高频问题做梳理和解答。
一、集群启动类问题
1. HMaster启动后自动退出
这类问题通常和ZooKeeper连接、HDFS权限有关，首先查看HMaster的日志，常见报错有两种：
- ZooKeeper连接超时：检查ZooKeeper集群是否正常启动，HBase配置文件
hbase-site.xml中的hbase.zookeeper.quorum配置是否正确，端口是否和ZooKeeper实际端口一致。 - HDFS目录权限不足：HBase需要在HDFS上有对应的数据存储目录，默认是
/hbase，检查该目录的权限是否属于HBase运行用户，可通过以下命令修改权限：
# 修改HDFS上hbase目录权限 hadoop fs -chown -R hbase:hbase /hbase
2. RegionServer无法注册到集群
RegionServer启动后日志显示无法连接HMaster，首先检查网络是否通畅，防火墙是否关闭，然后检查hbase-site.xml中的hbase.master.info.port配置是否和HMaster实际端口匹配，同时确认RegionServer节点的时间和HMaster节点时间差不超过30秒，时间不同步会导致注册失败。
二、运行稳定性问题
1. RegionServer频繁宕机
查看RegionServer日志，常见原因有内存溢出、GC时间过长：
- 内存配置不合理：HBase0.9x默认的RegionServer堆内存较小，可根据服务器实际内存调整
hbase-env.sh中的HBASE_REGIONSERVER_OPTS参数，示例配置如下：
# 设置RegionServer堆内存为8G，调整GC参数 export HBASE_REGIONSERVER_OPTS="-Xmx8g -Xms8g -XX:+UseG1GC -XX:MaxGCPauseMillis=200"
- GC停顿过长：如果使用的是CMS GC，可调整
CMSInitiatingOccupancyFraction参数，避免内存占满才触发GC。
2. ZooKeeper连接异常断开
日志中出现KeeperErrorCode = ConnectionLoss报错，首先检查ZooKeeper集群的负载，是否因为会话超时时间设置过短导致，可在hbase-site.xml中调整以下参数：
<property> <name>hbase.zookeeper.property.tickTime</name> <value>2000</value> </property> <property> <name>zookeeper.session.timeout</name> <value>60000</value> </property>
三、数据操作类问题
1. 数据写入超时
写入数据时客户端报超时错误，首先排查RegionServer负载，是否有大量Region处于分裂或者合并状态，可通过HBase Web UI查看Region状态。如果是写入量过大导致，可调整客户端的写入参数：
// 调整HBase客户端写入配置
Configuration config = HBaseConfiguration.create();
// 设置写入超时时间为30秒
config.set("hbase.client.operation.timeout", "30000");
// 设置写入重试次数为3次
config.set("hbase.client.retries.number", "3");
// 关闭自动刷新，批量写入
config.set("hbase.client.write.buffer", "5242880");2. 数据读取不到或者数据不一致
这类问题通常和MemStore刷新、WAL日志有关，首先确认数据是否已经写入MemStore，可手动触发MemStore刷新：
# 进入HBase shell手动刷新指定表 hbase shell flush 'table_name'
如果是WAL日志损坏导致，可尝试关闭WAL写入（仅测试环境使用，生产环境不建议），或者从备份的WAL日志中恢复数据。
四、问题排查通用思路
遇到HBase0.9x的问题时，优先查看对应组件的日志，日志路径默认在$HBASE_HOME/logs目录下，根据日志中的报错关键字搜索官方issue或者社区解决方案，同时可通过HBase自带的hbase hbck命令检查集群元数据的一致性，修复元数据错误。
注意：HBase0.9x已经停止官方维护，生产环境建议升级到更高稳定版本，老版本仅适合学习或者存量项目维护使用。
