WildFly EAR部署中jackson-jaxrs冲突致序列化失效问题咨询

让我帮你理清楚这个问题——我之前在维护WildFly上的Java EE应用时，也碰到过几乎一模一样的Jackson类加载冲突场景，刚好能解释清楚你的疑问。

一、两种使用方式的核心区别 #

1. 类加载的优先级与隔离性完全不同 #

• WildFly自带的Jackson模块：它是WildFly容器通过自己的模块化类加载器管理的，属于容器级别的依赖。RestEasy（WildFly默认的JAX-RS实现）已经和这个模块深度绑定，类加载时会优先使用容器模块里的Jackson类，而且遵循JBoss的类隔离规则——应用里的同名类不会覆盖容器的类，除非你主动改配置。
• EAR lib中的jackson-jaxrs：这些JAR属于应用级类加载器的范围，相当于你把Jackson的JAX-RS提供者打包进了自己的应用里。这时候就会触发类加载冲突：RestEasy可能会优先使用你应用里的Jackson提供者，而不是容器自带的集成版本，导致类的上下文完全混乱。

2. 与RestEasy的集成程度天差地别 #

• 容器自带的Jackson模块是和RestEasy深度整合好的：它已经帮你配置好了默认的ObjectMapper、注册了Java 8日期类型的支持模块（jackson-datatype-jsr310），并且会自动识别你的@JsonSerialize/@JsonDeserialize注解——因为RestEasy的JAX-RS提供者已经把这些配置都绑定到了容器的上下文里。
• 你自己放进EAR lib的jackson-jaxrs就是个“裸”的依赖包：它不会自动和RestEasy的上下文联动，初始化的ObjectMapper是全新的、未配置的默认实例，既没有注册Java 8日期模块，也不会自动扫描你代码里的注解绑定，完全是个“白板”状态。

二、为什么加了jackson-jaxrs后注解就失效了？ #

你碰到的问题本质是类加载冲突+Jackson上下文初始化错误，具体有三个关键点：

1. ObjectMapper上下文不匹配
   当你把jackson-jaxrs放进EAR lib后，RestEasy会切换到使用应用类加载器里的Jackson提供者，这个提供者初始化的ObjectMapper是全新的，根本不知道你代码里用@JsonSerialize/@JsonDeserialize指定的序列化器/反序列化器——默认的ObjectMapper不会自动识别这些自定义绑定，必须显式配置才会生效。

2. 缺少Java 8日期支持依赖
   WildFly自带的Jackson模块已经包含了jackson-datatype-jsr310（专门处理Java 8日期类型的模块），所以能正确序列化/反序列化OffsetDateTime。但你加的jackson-jaxrs可能只包含了JAX-RS的绑定代码，没带这个日期模块，导致新的ObjectMapper把OffsetDateTime当成普通Java对象处理——反序列化时没法把字符串转成日期类型，序列化时就输出一堆内部字段。

3. 注解的类加载隔离问题
   你WAR里用的@JsonSerialize/@JsonDeserialize注解是来自容器模块的Jackson类，而EAR lib里的Jackson提供者是来自应用类加载器的——在Java里，同一个类名但来自不同类加载器的类会被视为完全不同的类型，所以提供者根本识别不了你WAR里的注解，自然就不会处理它们。

三、如果必须保留EAR lib中的jackson-jaxrs，怎么修复？ #

如果另一个WAR确实需要这个依赖，你可以通过以下两种方式解决：

方式1：强制使用容器的Jackson模块 #

在EAR的META-INF/jboss-deployment-structure.xml里配置，让应用排除自己的Jackson类，强制使用容器自带的模块：

<jboss-deployment-structure>
    <deployment>
        <!-- 排除应用里的Jackson类 -->
        <exclusions>
            <module name="com.fasterxml.jackson.jaxrs.jackson-jaxrs-json-provider" />
            <module name="com.fasterxml.jackson.core.jackson-core" />
            <module name="com.fasterxml.jackson.core.jackson-databind" />
            <module name="com.fasterxml.jackson.core.jackson-annotations" />
        </exclusions>
        <!-- 引入容器的Jackson模块，并导出给子WAR使用 -->
        <dependencies>
            <module name="com.fasterxml.jackson.jaxrs.jackson-jaxrs-json-provider" export="true" />
            <module name="com.fasterxml.jackson.datatype.jackson-datatype-jsr310" export="true" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

方式2：统一配置Jackson上下文 #

在你的REST服务所在的WAR里，显式注册一个ContextResolver，手动配置ObjectMapper：

@Provider
public class CustomObjectMapperResolver implements ContextResolver<ObjectMapper> {
    private final ObjectMapper objectMapper;

    public CustomObjectMapperResolver() {
        objectMapper = new ObjectMapper();
        // 注册Java 8日期模块
        objectMapper.registerModule(new JavaTimeModule());
        // 手动绑定你的自定义序列化器/反序列化器
        objectMapper.addSerializer(OffsetDateTime.class, new YourOffsetDateTimeSerializer());
        objectMapper.addDeserializer(OffsetDateTime.class, new YourOffsetDateTimeDeserializer());
    }

    @Override
    public ObjectMapper getContext(Class<?> type) {
        return objectMapper;
    }
}

这样不管RestEasy用哪个Jackson提供者，都会使用你配置好的ObjectMapper，注解就能正常生效了。

内容的提问来源于stack exchange，提问作者Alexander Rühl