Maven项目排除WildFly模块并强制使用Jackson 2.9.9的问题

我最近在将一个Maven项目部署到WildFly 8.2.1时遇到了Jackson版本冲突的问题，具体情况如下：

项目依赖与服务器环境 #

项目中引入的核心依赖：

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-joda</artifactId>
    <version>2.9.9</version>
</dependency>

它的传递依赖包含：

• com.fasterxml.jackson.core:jackson-annotations:2.9.0
• com.fasterxml.jackson.core:jackson-core:2.9.9
• com.fasterxml.jackson.core:jackson-databind:2.9.9
• javax.servlet:javax.servlet-api:3.1.0
• joda-time:joda-time:2.7

但WildFly 8.2.1服务器modules/system/layers/base目录中提供的对应依赖版本更低：

• com/fasterxml/jackson/core/jackson-annotations/main/jackson-annotations-2.4.1.jar
• com/fasterxml/jackson/core/jackson-core/main/jackson-core-2.4.1.jar
• com/fasterxml/jackson/core/jackson-databind/main/jackson-databind-2.4.1.jar
• javax/servlet/api/main/jboss-servlet-api_3.1_spec-1.0.0.Final
• org/joda/time/main/joda-time-1.6.2.jar

问题现象与尝试过的方案 #

运行应用时因databind版本不匹配报错：jackson-datatype-joda依赖的字段在2.4.1版本中不存在，必须使用2.9.9版本的databind。

我尝试了四种方案，仅两种有效：

1. 在pom.xml手动添加databind 2.9.9依赖 → 错误依旧
2. 通过jboss-deployment-structure.xml排除WildFly的databind模块 → 错误依旧
3. 修改WildFly模块替换为2.9.9版本 → 有效，但不想修改服务器
4. 降级jackson-datatype-joda到2.4.1版本 → 有效，但现有代码依赖2.9.9无法降级

想请教：为什么WildFly忽略了我的模块覆盖尝试？有没有办法强制使用databind 2.9.9版本？

为什么WildFly会忽略你的覆盖尝试？ #

首先得明白WildFly的模块优先类加载机制：它会优先从自身的模块仓库加载类，而非应用包（WAR/EAR）中的类——除非你明确配置了类加载优先级，或者完全排除了服务器模块。

• 方案1无效的原因：即使你在pom中添加了databind 2.9.9，WildFly依然会优先加载自身的2.4.1版本，应用包中的jar根本没机会被加载。
• 方案2无效的原因：大概率是你的jboss-deployment-structure.xml配置不完整，比如只排除了databind模块，但没排除相关的annotations、core模块，或者这些模块被其他服务器模块间接依赖，导致版本仍不匹配。

如何强制使用databind 2.9.9版本？ #

这里有两种无需修改服务器的可靠方案：

方案一：完善jboss-deployment-structure.xml的排除配置

要彻底排除WildFly的所有Jackson核心模块，确保应用自身的Jackson jar被优先加载。正确配置如下：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <!-- 排除所有Jackson核心模块 -->
            <module name="com.fasterxml.jackson.core.jackson-annotations" />
            <module name="com.fasterxml.jackson.core.jackson-core" />
            <module name="com.fasterxml.jackson.core.jackson-databind" />
            <!-- 若存在Jackson相关的JAX-RS模块，也需排除 -->
            <module name="com.fasterxml.jackson.jaxrs.jackson-jaxrs-json-provider" />
        </exclusions>
        <dependencies>
            <!-- 保留必要的服务器依赖，比如Servlet API -->
            <module name="javax.servlet.api" export="true" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

将该文件放置在WAR包的WEB-INF目录或EAR包的META-INF目录下。同时要确保Maven依赖的scope为默认的compile（不要设为provided），这样Jackson的jar会被打包到WEB-INF/lib中。

方案二：使用WildFly类加载隔离特性

通过配置让应用类加载器优先于服务器模块加载类，在jboss-deployment-structure.xml中添加：

<jboss-deployment-structure>
    <deployment>
        <class-loading>
            <!-- 提升应用类加载器优先级 -->
            <module-name>deployment.你的应用名称.war</module-name>
            <priority value="1000" />
            <export-all>true</export-all>
        </class-loading>
        <!-- 可选：若仍有冲突，补充排除Jackson模块 -->
        <exclusions>
            <module name="com.fasterxml.jackson.core.jackson-annotations" />
            <module name="com.fasterxml.jackson.core.jackson-core" />
            <module name="com.fasterxml.jackson.core.jackson-databind" />
        </exclusions>
    </deployment>
</jboss-deployment-structure>

这个配置会让应用包中的Jackson类先被加载，从而覆盖服务器的低版本。

验证配置是否生效 #

可以在应用中添加一个简单的版本检查类，确认是否使用了2.9.9版本：

import com.fasterxml.jackson.databind.ObjectMapper;

public class JacksonVersionChecker {
    public static void checkVersion() {
        ObjectMapper mapper = new ObjectMapper();
        System.out.println("Jackson Databind Version: " + mapper.version());
    }
}

在应用启动时调用该方法，查看控制台输出的版本是否为2.9.9即可验证配置是否生效。

内容的提问来源于stack exchange，提问作者Snowy Coder Girl