升级Java、HBase及Spring Boot后HBase客户端认证加载失败求助

1. 修复Spring Boot与HBase的依赖冲突 #

Spring Boot 3.x的依赖管理会自动管控部分Hadoop相关包的版本，导致HBase shaded client需要的认证类被覆盖或排除。直接调整依赖配置：

• 在pom.xml里显式声明HBase客户端依赖，排除冲突的Hadoop模块，同时引入兼容的Hadoop Common：

<dependency>
    <groupId>org.apache.hbase</groupId>
    <artifactId>hbase-shaded-client</artifactId>
    <version>2.5.4</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.hadoop</groupId>
            <artifactId>hadoop-common</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<dependency>
    <groupId>org.apache.hadoop</groupId>
    <artifactId>hadoop-common</artifactId>
    <version>3.3.4</version> <!-- 该版本与HBase 2.5.4完全兼容 -->
    <scope>runtime</scope>
</dependency>

如果使用Gradle，对应配置：

implementation('org.apache.hbase:hbase-shaded-client:2.5.4') {
    exclude group: 'org.apache.hadoop', module: 'hadoop-common'
}
runtimeOnly 'org.apache.hadoop:hadoop-common:3.3.4'

2. 给Java 17添加必要的模块开放参数 #

Java 17的模块化系统会限制HBase客户端访问某些核心类，在JVM启动参数里追加：

--add-opens java.base/java.net=ALL-UNNAMED
--add-opens java.base/java.io=ALL-UNNAMED
--add-opens java.security.jgss/sun.security.krb5=ALL-UNNAMED

Kubernetes部署场景下，直接在容器的启动命令中添加这些参数即可。

3. 补全openjdk-slim镜像的系统依赖 #

openjdk-slim镜像缺少Kerberos相关本地库，会导致认证类加载失败。修改Dockerfile：

RUN apt-get update && apt-get install -y --no-install-recommends libkrb5-dev \
    && rm -rf /var/lib/apt/lists/*

安装后Kerberos相关依赖即可齐全。

4. 排除Spring Boot无关的自动配置 #

Spring Boot的数据库自动配置可能干扰HBase的类路径扫描，在启动类上加注解排除：

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, HibernateJpaAutoConfiguration.class})

若应用不需要JDBC数据库，此操作可避免不必要的类冲突。

5. 检查依赖树确保无重复冲突 #

用mvn dependency:tree（Gradle用./gradlew dependencies）输出依赖树，搜索org.apache.hadoop.security.authentication，确保仅存在一个版本，避免类加载混乱。

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