PySpark写入BigTable遇java.lang.NoClassDefFoundError问题求助

我正在Google Dataproc集群上执行将DataFrame写入BigTable的PySpark任务，但遇到如下错误。

写入BigTable的代码 #

input_data.write \
    .format("org.apache.hadoop.hbase.spark") \
    .option('hbase.spark.use.hbasecontext', "false") \
    .options(catalog=catalog) \
    .save()

错误堆栈信息 #

Traceback (most recent call last):
  File "/tmp/d0a5ee7ae9a24f92958025c0d6de370e/bigtable_test.py", line 57, in <module>
    main(spark)
  File "/tmp/d0a5ee7ae9a24f92958025c0d6de370e/bigtable_test.py", line 31, in main
    input_data.write \
  File "/usr/lib/spark/python/lib/pyspark.zip/pyspark/sql/readwriter.py", line 1107, in save
  File "/usr/lib/spark/python/lib/py4j-0.10.9-src.zip/py4j/java_gateway.py", line 1304, in __call__
  File "/usr/lib/spark/python/lib/pyspark.zip/pyspark/sql/utils.py", line 111, in deco
  File "/usr/lib/spark/python/lib/py4j-0.10.9-src.zip/py4j/protocol.py", line 326, in get_return_value
py4j.protocol.Py4JJavaError: An error occurred while calling o255.save.
: java.lang.NoClassDefFoundError: org/apache/hadoop/hbase/client/TableDescriptor
        at org.apache.hadoop.hbase.spark.DefaultSource.createRelation(DefaultSource.scala:78)
        at org.apache.spark.sql.execution.datasources.SaveIntoDataSourceCommand.run(SaveIntoDataSourceCommand.scala:46)
        at org.apache.spark.sql.execution.command.ExecutedCommandExec.sideEffectResult$lzycompute(commands.scala:70)
        at org.apache.spark.sql.execution.command.ExecutedCommandExec.sideEffectResult(commands.scala:68)
        at org.apache.spark.sql.execution.command.ExecutedCommandExec.doExecute(commands.scala:90)
        at org.apache.spark.sql.execution.SparkPlan.$anonfun$execute$1(SparkPlan.scala:180)
        at org.apache.spark.sql.execution.SparkPlan.$anonfun$executeQuery$1(SparkPlan.scala:218)
        at org.apache.spark.rdd.RDDOperationScope$.withScope(RDDOperationScope.scala:151)
        at org.apache.spark.sql.execution.SparkPlan.executeQuery(SparkPlan.scala:215)
        at org.apache.spark.sql.execution.SparkPlan.execute(SparkPlan.scala:176)
        at org.apache.spark.sql.execution.QueryExecution.toRdd$lzycompute(QueryExecution.scala:132)
        at org.apache.spark.sql.execution.QueryExecution.toRdd(QueryExecution.scala:131)
        at org.apache.spark.sql.DataFrameWriter.$anonfun$runCommand$1(DataFrameWriter.scala:989)
        at org.apache.spark.sql.execution.SQLExecution$.$anonfun$withNewExecutionId$5(SQLExecution.scala:103)
        at org.apache.spark.sql.execution.SQLExecution$.withSQLConfPropagated(SQLExecution.scala:163)
        at org.apache.spark.sql.execution.SQLExecution$.$anonfun$withNewExecutionId$1(SQLExecution.scala:90)
        at org.apache.spark.sql.SparkSession.withActive(SparkSession.scala:775)
        at org.apache.spark.sql.execution.SQLExecution$.withNewExecutionId(SQLExecution.scala:64)
        at org.apache.spark.sql.DataFrameWriter.runCommand(DataFrameWriter.scala:989)
        at org.apache.spark.sql.DataFrameWriter.saveToV1Source(DataFrameWriter.scala:438)
        at org.apache.spark.sql.DataFrameWriter.saveInternal(DataFrameWriter.scala:415)
        at org.apache.spark.sql.DataFrameWriter.save(DataFrameWriter.scala:301)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
        at java.lang.reflect.Method.invoke(Method.java:498)
        at py4j.reflection.MethodInvoker.invoke(MethodInvoker.java:244)
        at py4j.reflection.ReflectionEngine.invoke(ReflectionEngine.java:357)
        at py4j.Gateway.invoke(Gateway.java:282)
        at py4j.commands.AbstractCommand.invokeMethod(AbstractCommand.java:132)
        at py4j.commands.CallCommand.execute(CallCommand.java:79)
        at py4j.GatewayConnection.run(GatewayConnection.java:238)
        at java.lang.Thread.run(Thread.java:748)
Caused by: java.lang.ClassNotFoundException: org.apache.hadoop.hbase.client.TableDescriptor
        at java.net.URLClassLoader.findClass(URLClassLoader.java:387)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:352)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
        ... 33 more

已配置的ClassPath #

我已为HBase连接器配置以下extraClassPath属性，并确认配置正确：

• ('spark.executor.extraClassPath', '/home/airflow/gcs/dags/lumiteam-data-transformation/cbt_test/hbase-spark-1.0.1-SNAPSHOT.jar')
• ('spark.driver.extraClassPath', '/home/airflow/gcs/dags/lumiteam-data-transformation/cbt_test/hbase-spark-1.0.1-SNAPSHOT.jar')

解决方案 #

• 检查版本兼容性
  org.apache.hadoop.hbase.client.TableDescriptor是HBase 2.x新增类，HBase 1.x中对应类为HTableDescriptor。若Dataproc集群用HBase 1.x，但hbase-spark连接器基于HBase 2.x编译，就会触发该类找不到的错误。

• 替换匹配版本的hbase-spark连接器
  确保hbase-spark jar包版本与集群HBase版本一致：

  • 集群为HBase 1.x时，使用1.x版本的hbase-spark（如1.4.9）
  • 集群为HBase 2.x时，使用2.x版本的hbase-spark（如2.4.9）

• 补全依赖包
  仅添加hbase-spark.jar不足以满足需求，需确保HBase核心依赖（如hbase-client.jar、hbase-common.jar等）也在ClassPath中。可通过两种方式补充：

  • 提交Spark任务时用--jars参数指定所有必需的HBase依赖jar包
  • 将HBase依赖包放到spark.driver.extraClassPath和spark.executor.extraClassPath指定的路径下

• Dataproc专属配置优化
  在Dataproc集群上，建议用官方HBase集成配置，或通过初始化动作安装匹配版本的HBase组件，从根源避免版本不兼容问题。

内容的提问来源于stack exchange，提问作者Piyush Namra