JAR部署致JBoss启动报错：JaxbAnnotationModule类型不兼容咨询

问题概述 #

• 提供给客户端的JAR文件，本地通过java -jar (name).jar测试执行完全正常
• 客户端部署到JBoss服务器后，启动时抛出错误：

  com/fasterxml/jackson/module/jaxb/JaxbAnnotationModule is not assignable to com/fasterxml/jackson/databind/module

• 回滚至旧版本JAR后，JBoss服务器启动恢复正常

核心原因 #

这是典型的类加载版本冲突：JBoss应用服务器内置了Jackson类库，而你的JAR中打包的Jackson版本与JBoss内置版本不兼容，导致类加载时出现类型不匹配。本地独立运行时，JVM仅加载JAR自身的依赖，无外部类干扰，因此不会触发冲突。

解决方案 #

1. 排查JBoss内置Jackson版本 #

• 进入JBoss安装目录，找到路径modules/system/layers/base/com/fasterxml/jackson，查看内置Jackson模块的版本（如2.9.x、2.12.x）
• 对比你JAR依赖的Jackson版本，确认是否存在跨大版本差异（比如你的JAR用2.15.x，JBoss内置2.9.x）

2. 调整依赖范围，避免打包冲突类库 #

如果项目使用Maven构建，修改pom.xml中Jackson相关依赖的<scope>为provided，让JBoss提供这些依赖，不打包进JAR：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>你的Jackson版本</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-jaxb-annotations</artifactId>
    <version>你的Jackson版本</version>
    <scope>provided</scope>
</dependency>

注意：需确保JBoss内置Jackson版本与你的代码API兼容，否则可能引发其他兼容性问题

3. 配置JBoss部署结构，优先加载JAR内的Jackson #

如果必须使用特定版本的Jackson，可在JAR的META-INF/jboss-deployment-structure.xml中添加配置，让JBoss排除内置Jackson模块，优先加载JAR中的版本：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="com.fasterxml.jackson.core.jackson-core"/>
            <module name="com.fasterxml.jackson.core.jackson-databind"/>
            <module name="com.fasterxml.jackson.module.jackson-module-jaxb-annotations"/>
        </exclusions>
        <local-last value="true"/>
    </deployment>
</jboss-deployment-structure>

4. 统一项目Jackson依赖版本 #

使用依赖分析工具检查项目依赖树，确保所有Jackson相关依赖版本一致：

• Maven：执行mvn dependency:tree
• Gradle：执行gradle dependencies
  清理依赖树中混入的不同版本Jackson类，避免JAR内出现版本冲突

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