JerseyTest中Jackson注解生效但Tomcat中失效的排查求助

我之前碰到过几乎一模一样的问题，这种情况大概率是Jersey在Tomcat环境下没有正确绑定Jackson的注解模块，或者类加载器冲突导致Jackson注解处理器没被正常加载。结合你描述的“手动注册反序列化器生效但注解失效”的现象，给你几个排查和解决的方向：

1. 确保Jackson依赖完整且版本一致 #

首先检查你的WEB-INF/lib目录，确认以下几个Jackson相关jar包都存在，并且版本完全统一：

• jackson-annotations.jar（注解核心包）
• jackson-databind.jar（数据绑定核心）
• jackson-jaxrs-json-provider.jar（Jersey与Jackson的桥接包）

如果Tomcat的lib目录下存在旧版本的Jackson jar，会优先被加载，直接导致你应用里的新版本注解无法生效。这种情况直接删除Tomcat lib下的Jackson相关文件即可。

2. 显式注册带注解支持的JacksonJsonProvider #

不要依赖Jersey的默认配置，手动在你的Jersey配置类里注册Jackson提供者，并确保ObjectMapper显式绑定注解模块：

public class MyJerseyApplication extends ResourceConfig {
    public MyJerseyApplication() {
        // 扫描你的API资源包
        packages("com.your.api.package");
        
        // 显式注册JacksonJsonProvider，传入自定义配置的ObjectMapper
        register(new JacksonJsonProvider(createDefaultMapper()));
    }

    private static ObjectMapper createDefaultMapper() {
        final ObjectMapper mapper = new ObjectMapper();
        final SimpleModule module = new SimpleModule();
        module.addDeserializer(MyEntity.class, new MyEntityDeserializer());
        
        mapper.enable(SerializationFeature.INDENT_OUTPUT);
        // 强制注册Jackson注解模块，避免类加载问题导致自动注册失败
        mapper.registerModule(new JacksonAnnotationModule());
        mapper.registerModule(module);
        
        // 可以加一行日志验证模块是否注册成功
        System.out.println("已注册的Jackson模块: " + mapper.getRegisteredModules());
        return mapper;
    }
}

3. 检查web.xml的Jersey配置 #

如果是通过web.xml配置Jersey Servlet，确保指定了自定义的Application类，避免与自动扫描的提供者冲突：

<servlet>
    <servlet-name>JerseyServlet</servlet-name>
    <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
    <init-param>
        <param-name>javax.ws.rs.Application</param-name>
        <param-value>com.your.config.MyJerseyApplication</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

不要同时配置jersey.config.server.provider.packages和自定义Application类，这会导致配置冲突。

4. 验证注解使用的正确性 #

有些注解的生效是有前置条件的，比如@JsonCreator：
在Java 8之前的版本，如果构造函数或工厂方法没有显式用@JsonProperty指定参数对应字段，Jackson无法识别参数名，会导致注解失效：

public class MyEntity {
    private String userId;

    // 必须加@JsonProperty指定字段名
    @JsonCreator
    public MyEntity(@JsonProperty("userId") String userId) {
        this.userId = userId;
    }
}

5. 排查类加载器问题 #

如果以上步骤都无效，可以通过Tomcat的日志打印类加载路径，确认Jackson相关类是从你的应用WEB-INF/lib加载，而不是Tomcat的全局lib：
在你的应用启动代码中加入：

System.out.println("JacksonAnnotation类加载路径: " + JacksonAnnotation.class.getProtectionDomain().getCodeSource().getLocation());

如果输出的是Tomcat lib目录的路径，说明存在类加载冲突，需要清理Tomcat全局lib下的Jackson包。

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