HBase Client API无法连接HBase，抛出SocketTimeoutException问题求助

首先得明确：在Kerberos环境下连接HBase，不是只放个hbase-site.xml就够的，得把Kerberos认证的全流程配置到位，而且Spark提交时的参数也有讲究。我给你梳理几个关键步骤：

1. 确保hbase-site.xml配置正确且被正确加载 #

• 先检查你的hbase-site.xml里有没有这些核心Kerberos相关配置：

  <property>
    <name>hbase.security.authentication</name>
    <value>kerberos</value>
  </property>
  <property>
    <name>hbase.master.kerberos.principal</name>
    <value>hbase/_HOST@YOUR-REALM.COM</value>
  </property>
  <property>
    <name>hbase.regionserver.kerberos.principal</name>
    <value>hbase/_HOST@YOUR-REALM.COM</value>
  </property>
  <property>
    <name>hbase.zookeeper.quorum</name>
    <value>zk-node1,zk-node2,zk-node3</value>
  </property>
  <property>
    <name>hbase.zookeeper.property.clientPort</name>
    <value>2181</value>
  </property>
  

• Maven项目里，把hbase-site.xml放在src/main/resources目录下，打包时要确保它被打进JAR包中。如果是Spark提交，不要用--jars传这个xml文件，正确做法是用--files hbase-site.xml把它分发到每个节点，这样Spark的Driver和Executor都能读取到。

2. 配置Kerberos认证相关文件 #

• 把krb5.conf也放到src/main/resources，或者通过--files krb5.conf传入Spark。同时在Spark提交参数中指定Kerberos配置路径：

  spark-submit \
    --files hbase-site.xml,krb5.conf \
    --conf spark.driver.extraJavaOptions="-Djava.security.krb5.conf=./krb5.conf" \
    --conf spark.executor.extraJavaOptions="-Djava.security.krb5.conf=./krb5.conf" \
    # 其他必要参数...
  

• 要确保运行环境能获取到有效的Kerberos凭证（keytab文件），推荐在代码里手动完成Kerberos登录（比提前用kinit更稳定，适合集群运行场景）：

  Configuration conf = HBaseConfiguration.create();
  conf.set("hadoop.security.authentication", "kerberos");
  UserGroupInformation.setConfiguration(conf);
  UserGroupInformation.loginUserFromKeytab("your-principal@YOUR-REALM.COM", "/path/to/your.keytab");
  

  如果是Spark集群模式提交，keytab也要通过--files传入，因为Driver会在YARN节点上运行，本地路径不可用。

3. 匹配HBase客户端依赖版本 #

• 一定要保证你的Maven依赖里的HBase客户端版本和Cloudera集群的HBase版本完全匹配（包括小版本），Cloudera的版本是定制过的，比如CDH 6.3.4对应的HBase版本是2.1.0-cdh6.3.4，别用原生Apache的HBase依赖，否则会出现兼容性问题：

  <dependency>
    <groupId>org.apache.hbase</groupId>
    <artifactId>hbase-client</artifactId>
    <version>2.1.0-cdh6.3.4</version>
  </dependency>
  <dependency>
    <groupId>org.apache.hbase</groupId>
    <artifactId>hbase-common</artifactId>
    <version>2.1.0-cdh6.3.4</version>
  </dependency>
  

  如果找不到Cloudera的依赖，需要在pom.xml里添加Cloudera的仓库：

  <repository>
    <id>cloudera</id>
    <url>https://repository.cloudera.com/artifactory/cloudera-repos/</url>
  </repository>
  

4. Spark提交的额外安全配置 #

• 除了上面的--files和Java参数，还要补充Spark的安全配置项，以YARN集群模式为例：

  spark-submit \
    --master yarn \
    --deploy-mode cluster \
    --files hbase-site.xml,krb5.conf,your.keytab \
    --conf spark.driver.extraJavaOptions="-Djava.security.krb5.conf=./krb5.conf" \
    --conf spark.executor.extraJavaOptions="-Djava.security.krb5.conf=./krb5.conf" \
    --conf spark.hadoop.security.authentication=kerberos \
    --conf spark.yarn.principal=your-principal@YOUR-REALM.COM \
    --conf spark.yarn.keytab=./your.keytab \
    --class com.your.package.YourHBaseApp \
    your-app.jar
  

5. 错误日志排查关键点 #

如果还是失败，一定要盯着错误日志找线索：

• 出现GSSException：大概率是Kerberos认证失败，检查principal、keytab、krb5.conf的配置是否正确，比如REALM名称大小写、keytab权限等。
• 出现NoServerForRegionException：可能是hbase-site.xml里的ZooKeeper地址不对，或者客户端与集群HBase版本不兼容。
• 出现ClassNotFoundException：说明依赖包缺失或者版本不匹配，检查Maven依赖是否完整。

按照这些步骤逐一排查，应该能解决大部分Kerberos环境下HBase连接的问题。

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