用户侧可优先排查的项

1、时间同步：HBase 与 ZooKeeper 对节点时间差异敏感，时间不同步会引发大量莫名故障，请先确认客户端与集群时间一致。

2、客户端配置：核对 hbase-site.xml 中 hbase.rootdir、zookeeper.znode.parent、zookeeper.quorum 等与集群一致。

3、Kerberos 凭证：安全模式下确认 keytab 有效且已 kinit，用户具备对应权限。

4、日志与 WebUI：通过翼MR Manager 查看相关角色日志与 WebUI 指标，定位报错关键字。

启动类故障

现象	原因与处理
RegionServer 启动失败，报 ClockOutOfSyncException（时间差超阈值）	节点时间不同步。请同步集群时间（NTP）后重启该角色。
RegionServer 启动报端口绑定失败（BindException）	IP 配置错误或 16020 等端口被占用。核对机器 IP 与端口占用情况。
HMaster 启动后随即退出，报文件系统版本不符 / 版本文件损坏	多为升级或元数据损坏。请勿自行删改 HDFS 上的 hbase 目录，提交工单由运维使用 hbck 修复。
集群负载不均，部分 Region 集中	Load Balancer 未开启。进入 hbase shell 执行 balance_switch true 开启自动均衡（返回值为开启前的状态）。
启动失败，报压缩原生库（如 Snappy/LZO）无法加载	相关节点缺少原生压缩库。由运维确认各节点原生库一致并已正确安装。

现象	原因与处理
连接被拒绝 / ZooKeeper 会话超时	ZooKeeper 异常、网络不通、防火墙拦截或时间不同步。逐项排查 ZooKeeper 状态、网络、安全组与时钟；并确认 zookeeper.znode.parent 配置。
RegionServer 频繁挂掉，日志出现 WAL 同步失败 / 会话超时	常与 ZooKeeper 会话超时有关（如 tickTime 与 session 超时设置不合理）。由运维评估并调整 ZooKeeper 超时参数。
日志报 "Too many open files"	系统文件句柄数（ulimit）达到上限。由运维调大 ulimit 并重启相关角色。
客户端出现 SLF4J "multiple bindings" 告警	HBase 与 Hadoop 各自带了 SLF4J 绑定，属无害告警，去除重复 jar 即可消除。
报 NoSuchMethod / ClassNotFoundException（非业务类）	依赖版本冲突。确认客户端与集群 HBase / Hadoop 版本匹配，统一依赖版本后重试。

现象	原因与处理
建表失败，提示权限不足	当前用户无建表权限或命名空间写法不对。联系管理员授权，或按"命名空间:表名"格式建表。
hbase shell 中 list 等命令报错（znode data == null）	多因时间不同步或 hbase.rootdir 与 HDFS 配置不一致。先排时间同步，再核对配置。
查询报表不存在	表名/命名空间拼写错误。核对表名，必要时先 list 确认。
运行时报 HBase 相关类找不到	依赖包未打入或 HADOOP_CLASSPATH 未包含 HBase lib。确认依赖打包或客户端环境已引入。
执行 hbase hbck 报堆内存设置过大	底层 JVM 堆配置超限。提交工单由运维调整 HBASE_HEAPSIZE。

注意