ubuntu上hbase常见问题解答

1. HBase启动失败（Master/RegionServer无法启动）

• 现象：执行start-hbase.sh后，jps无HMaster或HRegionServer进程，或日志报错“Server is not running yet”。
• 可能原因及解决：
  • Java环境未正确配置：HBase依赖Java 8或11，需在hbase-env.sh中明确设置JAVA_HOME（如export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_441），并确保source ~/.bashrc生效。
  • 端口冲突：HBase默认使用16000（Master）、16020（RegionServer）等端口，若被其他进程占用，需修改hbase-site.xml中的对应端口（如<property><name>hbase.master.port</name><value>16010</value></property>）。
  • HDFS未正常运行：HBase依赖HDFS存储数据，需确保HDFS已启动（start-dfs.sh），且hbase.rootdir（如hdfs://localhost:9000/hbase）配置正确。
  • Zookeeper异常：若使用自带Zookeeper，需确保hbase.zookeeper.quorum（如localhost）配置正确，且Zookeeper服务正常（zkServer.sh status）。

2. 无法连接HBase Master（16010端口无法访问）

• 现象：浏览器访问http://localhost:16010报错“Connection refused”，或hbase shell连接时报错“Connection refused”。
• 可能原因及解决：
  • Master进程未启动：检查jps确认HMaster是否存在，若不存在，查看HMaster日志（位于logs目录）排查具体错误（如端口冲突、HDFS不可用）。
  • 防火墙阻止端口：Ubuntu默认防火墙（ufw）可能阻止16010端口，需执行sudo ufw allow 16010/tcp开放端口。
  • 配置文件错误：检查hbase-site.xml中的hbase.master.port是否与实际启动端口一致，或hbase.zookeeper.quorum是否指向正确的Zookeeper地址。

3. 数据目录权限问题（启动时报“Permission denied”）

• 现象：启动HBase时日志报错“Cannot create directory xxx: Permission denied”，或无法写入数据。
• 解决：HBase需要对其数据目录（hbase.rootdir指定的HDFS目录或本地目录）有读写权限。若使用本地目录（如/tmp/hbase-${user.name}/hbase），需执行sudo chown -R $USER:$USER /tmp/hbase-${user.name}；若使用HDFS目录，需确保HDFS用户（如hadoop）有权限（hdfs dfs -chmod -R 755 /hbase）。

4. Java版本不兼容

• 现象：启动HBase时报错“Unsupported major.minor version”或“Java version too high/low”。
• 解决：HBase 2.x系列推荐使用Java 8或11，HBase 3.x系列推荐使用Java 11及以上。通过java -version检查当前Java版本，若不符合要求，通过sudo apt install openjdk-11-jdk安装正确版本，并在hbase-env.sh中设置JAVA_HOME。

5. RegionServer启动后长时间处于“Initializing”状态

• 现象：jps显示HRegionServer进程存在，但HMaster界面显示RegionServer状态为“Initializing”，无法正常服务。
• 可能原因及解决：
  • HDFS NameNode未完全启动：等待NameNode启动完成（hdfs dfsadmin -report显示“Live datanodes”不为0），或重启HDFS（stop-dfs.sh && start-dfs.sh）。
  • Zookeeper连接超时：检查hbase-site.xml中的hbase.zookeeper.quorum和hbase.zookeeper.property.clientPort（默认2181）配置是否正确，或Zookeeper服务是否延迟。
  • 内存不足：RegionServer启动时内存不足（如hbase.regionserver.handler.count设置过高），需调整hbase-env.sh中的HBASE_HEAPSIZE（如export HBASE_HEAPSIZE=2G）。

6. 表操作异常（如“TableNotFoundException”“NamespaceNotFoundException”）

• 现象：执行create 'test', 'cf'或get 'test', 'row1'时报错“Table not found”或“Namespace does not exist”。
• 可能原因及解决：
  • 表未正确创建：确认表名拼写是否正确（区分大小写），或是否已创建（通过list命令查看所有表）。
  • 命名空间不存在：若表属于非默认命名空间（如my_ns:test），需先创建命名空间（create_namespace 'my_ns'）。
  • HBase服务未完全启动：等待HMaster和RegionServer均处于“running”状态（jps确认），再执行表操作。

7. 写入/读取性能差（延迟高、吞吐量低）

• 现象：写入时put命令响应慢，读取时get或scan命令耗时久，监控显示RegionServer负载高。
• 优化建议：
  • 硬件优化：使用SSD替代HDD提升IO性能，增加RegionServer内存（HBASE_HEAPSIZE设置为4G及以上）。
  • 配置调优：调整hbase.regionserver.handler.count（如30，增加处理线程数）、hbase.hregion.max.filesize（如10G，减少Region分裂次数）、hfile.block.cache.size（如0.4，增加读缓存比例）。
  • 表设计优化：RowKey设计避免热点（如添加哈希前缀），列族数量控制在1-3个（过多列族会增加IO开销），启用压缩（如snappy，hbase.hregion.compress设置为true）。
  • 查询优化：使用setCacheBlocks(false)禁用批量读取的缓存，使用Filter（如SingleColumnValueFilter）减少不必要的数据扫描，避免全表扫描。