如何让Jackson ObjectMapper适配含Jakarta注解的XJC生成类

针对你遇到的ObjectMapper未使用自定义JAXBElement序列化/反序列化器、无法直接解析字符串值的问题，按以下步骤排查和解决：

1. 确保自定义序列化器/反序列化器的实现正确 #

序列化器（只输出实际属性值） #

public class JAXBElementJsonSerializer extends JsonSerializer<JAXBElement<?>> {
    @Override
    public void serialize(JAXBElement<?> jaxbElement, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        // 直接序列化JAXBElement包裹的实际值，而非JAXBElement本身的结构
        gen.writeObject(jaxbElement.getValue());
    }
}

反序列化器（处理泛型类型，从字符串构造对应类型的JAXBElement） #

public class JAXBElementJsonDeserializer extends JsonDeserializer<JAXBElement<?>> {
    @Override
    public JAXBElement<?> deserialize(JsonParser parser, DeserializationContext ctxt) throws IOException {
        // 获取当前JAXBElement的泛型参数类型（比如XJC生成类中字段的实际类型）
        JavaType contextualType = ctxt.getContextualType();
        if (!(contextualType instanceof ParameterizedType)) {
            throw new IOException("无法解析JAXBElement的泛型类型");
        }
        ParameterizedType paramType = (ParameterizedType) contextualType;
        Class<?> valueType = (Class<?>) paramType.getActualTypeArguments()[0];
        
        // 解析输入的JSON值为实际类型
        Object actualValue = parser.readValueAs(valueType);
        
        // 构造JAXBElement：这里的QName需要根据XJC生成类的注解动态获取（示例用默认值，实际需调整）
        // 可通过反射读取字段的@XmlElementDecl/@XmlElementRef注解获取正确的QName
        QName qName = new QName("");
        return new JAXBElement<>(qName, valueType, actualValue);
    }
}

2. 正确注册自定义组件到Spring的ObjectMapper #

方式一：通过WebMvcConfigurer配置消息转换器 #

@Configuration
public class MyWebMvcConfigurer implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter();
        
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule customModule = new SimpleModule();
        
        // 注册自定义序列化/反序列化器
        customModule.addSerializer(JAXBElement.class, new JAXBElementJsonSerializer());
        customModule.addDeserializer(JAXBElement.class, new JAXBElementJsonDeserializer());
        
        // 注册Jakarta JAXB注解模块（兼容XJC生成类的注解）
        JakartaJaxbAnnotationModule jaxbModule = new JakartaJaxbAnnotationModule();
        objectMapper.registerModule(jaxbModule);
        objectMapper.registerModule(customModule);
        
        jacksonConverter.setObjectMapper(objectMapper);
        // 将自定义转换器放在最前面，优先使用
        converters.add(0, jacksonConverter);
    }
}

方式二：Spring Boot下直接注册全局ObjectMapper（推荐） #

@Configuration
public class JacksonConfig {
    @Bean
    @Primary
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule customModule = new SimpleModule();
        
        customModule.addSerializer(JAXBElement.class, new JAXBElementJsonSerializer());
        customModule.addDeserializer(JAXBElement.class, new JAXBElementJsonDeserializer());
        
        JakartaJaxbAnnotationModule jaxbModule = new JakartaJaxbAnnotationModule();
        objectMapper.registerModule(jaxbModule);
        objectMapper.registerModule(customModule);
        
        return objectMapper;
    }
}

3. 验证依赖配置正确 #

确保项目中引入了兼容Jakarta的Jackson和JAXB依赖：

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-jakarta-xmlbind-annotations</artifactId>
</dependency>
<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <scope>runtime</scope>
</dependency>

4. 关键注意事项 #

• 泛型处理：反序列化器必须通过ctxt.getContextualType()获取JAXBElement的实际泛型类型，否则无法正确解析不同类型的属性值。
• QName构造：实际项目中需通过反射读取XJC生成类字段的JAXB注解（如@XmlElementDecl）来获取正确的QName，示例中的默认QName仅作演示。
• 优先级：确保自定义的消息转换器或ObjectMapper覆盖Spring默认配置，避免默认组件拦截处理逻辑。

完成以上配置后，ObjectMapper会使用自定义序列化/反序列化器，允许客户端直接传入属性的原始值（如"timeout": "PT600S"），而非JAXBElement的嵌套结构。

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