在Wildfly服务器安装Hive JDBC驱动，解决WAR包连接Hive远程库异常

我之前也踩过Wildfly和Hive JDBC依赖冲突的坑，尤其是打包成WAR部署的时候，类加载隔离这块特别容易出问题——毕竟JAR是独立运行用自己的类加载器，WAR部署到Wildfly就得适配它的模块类加载机制。针对你遇到的Timeline类找不到的问题，给你几个实际可行的解决方案：

1. 用jboss-deployment-structure.xml隔离冲突依赖 #

Wildfly自带的部分模块（比如Hadoop相关的隐式依赖）可能和你WAR包里的Hive JDBC依赖产生类冲突，你可以通过这个配置文件强制让应用优先使用自身打包的依赖，同时排除Wildfly的冲突模块：

在WAR的WEB-INF目录下创建jboss-deployment-structure.xml，内容如下：

<jboss-deployment-structure>
    <deployment>
        <!-- 排除可能干扰的子系统 -->
        <exclude-subsystems>
            <subsystem name="datasources"/>
        </exclude-subsystems>
        <!-- 排除Wildfly自带的Hadoop/Hive相关模块，避免类冲突 -->
        <exclusions>
            <module name="org.apache.hadoop"/>
            <module name="org.apache.hive"/>
        </exclusions>
        <!-- 让应用自身的依赖优先加载，而不是Wildfly的模块 -->
        <local-last value="false"/>
    </deployment>
</jboss-deployment-structure>

2. 调整Maven依赖的Scope与排除传递冲突 #

检查你的pom.xml里Hive JDBC的依赖配置，排除掉可能和Wildfly冲突的传递依赖（比如Hadoop Yarn相关的包，Timeline类大概率来自这里）：

<dependency>
    <groupId>org.apache.hive</groupId>
    <artifactId>hive-jdbc</artifactId>
    <version>你的Hive版本号</version>
    <exclusions>
        <!-- 排除可能和Wildfly冲突的Yarn相关依赖 -->
        <exclusion>
            <groupId>org.apache.hadoop</groupId>
            <artifactId>hadoop-yarn-api</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.hadoop</groupId>
            <artifactId>hadoop-yarn-common</artifactId>
        </exclusion>
    </exclusions>
</dependency>

如果排除后出现其他类缺失，再手动添加兼容版本的对应依赖到pom.xml里。

3. 将Hive JDBC部署为Wildfly模块 #

把Hive JDBC及其所有依赖打包成Wildfly的系统模块，让服务器统一管理类加载，彻底避免应用内的依赖冲突：

1. 在Wildfly的modules/system/layers/base/org/apache/hive/main目录下，放入hive-jdbc.jar以及所有依赖的JAR包（比如Hadoop common、Hive service等）。
2. 同目录下创建module.xml：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="org.apache.hive">
    <resources>
        <resource-root path="hive-jdbc-xxx.jar"/>
        <resource-root path="hadoop-common-xxx.jar"/>
        <!-- 依次添加所有依赖的JAR路径 -->
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
        <module name="javax.servlet.api" optional="true"/>
    </dependencies>
</module>

3. 回到你的应用，修改jboss-deployment-structure.xml添加模块依赖：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="org.apache.hive" export="true"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

4. 最后把pom.xml里的Hive JDBC依赖改为provided，避免WAR包重复打包：

<dependency>
    <groupId>org.apache.hive</groupId>
    <artifactId>hive-jdbc</artifactId>
    <version>你的Hive版本号</version>
    <scope>provided</scope>
</dependency>

4. 定位冲突根源 #

如果以上方法还不行，你可以先确认Timeline类的来源：

• 用jar tf hive-jdbc-xxx.jar查看Hive JDBC包是否包含这个类；
• 用mvn dependency:tree生成依赖树，找到Timeline类所属的具体依赖；
• 对比Wildfly模块目录下是否有同名称但版本不同的JAR，这往往是类加载冲突的核心原因。

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