Ubuntu 上 HBase 启动失败的定位与修复
一、先快速定位
- 查看日志：第一时间打开 $HBASE_HOME/logs/hbase--master-.log 与 hbase--regionserver-.log，从最后几十行定位异常栈与报错关键词（如 ClassNotFoundException、Configuration parsing、ZooKeeper、HDFS、SLF4J 等）。
- 检查进程：执行 jps，确认是否存在 HMaster / HRegionServer（伪分布式还应看到 HQuorumPeer 若启用内置 ZK）。
- 检查 HDFS：执行 hdfs dfsadmin -report 或 hdfs dfs -ls /，确认 NameNode/DataNode 健康且 HBase 根目录可访问。
- 检查 ZooKeeper：执行 echo stat | nc <zk_host> 2181 或 zkCli.sh ls /，确认 Quorum 可达且 /hbase 节点状态正常。
- 核对配置：确认 JAVA_HOME、HBASE_HOME、PATH 已正确设置，且 hbase-site.xml / hbase-env.sh 语法与路径无误。
以上步骤能覆盖大多数启动失败场景，优先从日志入手可显著缩短排障时间。
二、常见原因与对应修复
- 使用了源码包而非二进制包：若解压的是 hbase-2.x.y-src.tar.gz，启动会报 “找不到或无法加载主类 … HBaseConfTool / ZKServerTool”。解决：改用 hbase-2.x.y-bin.tar.gz 预编译包再启动。
- 配置文件语法错误：如 hbase-site.xml 标签未闭合或缺失 ，会触发 Configuration parsing 异常。解决：用 XML 校验工具或 IDE 检查，确保标签成对且属性完整。
- HDFS 端口或地址不一致：HBase 指向 8020 而 Hadoop 实际监听 9000（或相反），会报连接失败。解决：在 hbase.rootdir 中显式写入与 core-site.xml 一致的 fs.defaultFS（如 hdfs://:9000/hbase）。
- ZooKeeper 连接或元数据残留：出现 ConnectionLoss for /hbase 或 TableExistsException: hbase:namespace，多为 ZK 未起、域名不一致或 /hbase znode 残留。解决：确认 HBASE_MANAGES_ZK 设置与 ZK 地址正确、集群时间误差不超过 30s，必要时在 ZK 中执行 rmr /hbase 清理后重启。
- SLF4J 日志绑定冲突：同时出现 slf4j-reload4j 与 log4j-slf4j-impl 会报多绑定警告并可能导致启动异常。解决：保留其一（如删除或重命名 slf4j-reload4j-*.jar 或 log4j-slf4j-impl-*.jar）。
- 权限问题：HDFS 目录权限不足会触发 AccessControlException。解决：以 hdfs 用户创建目录并赋权，或在环境变量中设置 export HADOOP_USER_NAME=hdfs 后再启动。
- 节点时间漂移：RegionServer 与 Master 时间差过大导致 ClockOutOfSyncException。解决：启用 NTP 同步，或在 hbase-site.xml 适度增大 hbase.master.maxclockskew（如 180000 ms）。
- 版本/兼容性：Hadoop、HBase、JDK 版本不匹配会导致 HMaster 闪退/无法启动。解决：对齐版本矩阵，优先使用同一大版本系列的组件。
以上问题在 Ubuntu 环境（含虚拟机与集群）中均较常见，按对应症状修复即可恢复启动。
三、分布式与内置 ZK 的关键配置示例
- 使用外部 ZooKeeper（推荐生产）
- hbase-env.sh
- export HBASE_MANAGES_ZK=false
- hbase-site.xml
- hbase.zookeeper.quorumzk1,zk2,zk3
- hbase.zookeeper.property.clientPort2181
- hbase.rootdirhdfs://:9000/hbase
- hbase.cluster.distributedtrue
- 使用内置 ZooKeeper（单机/测试）
- hbase-env.sh
- export HBASE_MANAGES_ZK=true
- hbase-site.xml
- hbase.rootdirhdfs://:9000/hbase
- hbase.cluster.distributedtrue
- hbase.zookeeper.property.dataDir/var/lib/hbase/zk
说明：端口与地址需与 Hadoop 的 core-site.xml 保持一致；域名（或主机名）在所有节点的 /etc/hosts 与配置中保持统一，避免解析不一致。
四、启动顺序与验证
- 启动顺序：先启动 HDFS（如 start-dfs.sh），再启动 ZooKeeper（内置或外部），最后启动 HBase（start-hbase.sh）。
- 快速验证：
- 进程：执行 jps，应看到 HMaster / HRegionServer（伪分布式含 HQuorumPeer）。
- Web UI：访问 http://:60010（旧版）或 http://:16010（常见新版），确认 Master 状态与 RegionServer 列表。
- Shell：执行 hbase shell，运行 status ‘detailed’ 查看集群健康度。
若 Master 未起来或 RegionServer 未注册，回到日志定位具体原因（HDFS 权限/路径、ZK 连接、端口不一致等）。
