ubuntu上hbase常見問題解答

1. HBase啟動失?。∕aster/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）減少不必要的數據掃描，避免全表掃描。