Spring Boot兼容XML/JSON请求响应：JAXB注解适配配置求助

问题背景 #

使用Java 1.8 + Spring Boot 2.7.17，通过cxf-codegen-plugin 3.0.3的wsdl2java目标从XSD生成POJO（无法修改XSD及POJO）。当前XML请求/响应能正常识别@XmlElement的name属性，但JSON请求/响应仅识别类字段名，导致数据解析异常。需要通过配置或依赖变更实现XML与JSON的兼容解析，且不修改POJO和控制器。

核心原因 #

CXF生成的POJO使用JAXB的@XmlElement注解标记字段的XML映射名称，但Spring Boot默认的JSON解析器Jackson，默认不会自动识别JAXB注解，而是直接使用类字段名进行JSON序列化/反序列化，导致XML与JSON的字段名不匹配。

解决方案 #

方案1：启用Jackson对JAXB注解的支持（最简配置） #

1. 添加Jackson的JAXB注解模块依赖
   在pom.xml中添加以下依赖（Spring Boot会自动匹配对应版本的Jackson模块）：

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-jaxb-annotations</artifactId>
</dependency>

2. 配置Jackson启用JAXB注解
   在application.properties或application.yml中添加配置：

# 让Jackson优先使用JAXB注解进行字段映射
spring.jackson.mapper.use-jaxb-annotations=true

此配置会让Jackson识别@XmlElement的name属性，将其作为JSON的字段名，同时保留原有的XML解析逻辑，完全兼容现有功能。

方案2：自定义Jackson配置（更灵活的控制） #

如果方案1无法满足需求（比如需要自定义字段映射逻辑），可以通过配置类自定义ObjectMapper：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.PropertyNamingStrategy;
import com.fasterxml.jackson.databind.cfg.MapperConfig;
import com.fasterxml.jackson.databind.introspect.AnnotatedField;
import com.fasterxml.jackson.databind.introspect.AnnotatedMethod;
import com.fasterxml.jackson.module.jaxb.JaxbAnnotationModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;

import javax.xml.bind.annotation.XmlElement;

@Configuration
public class JacksonJaxbConfig {

    @Bean
    public MappingJackson2HttpMessageConverter jacksonJaxbMessageConverter() {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        ObjectMapper objectMapper = new ObjectMapper();

        // 注册JAXB注解模块
        objectMapper.registerModule(new JaxbAnnotationModule());

        // 自定义字段命名策略：优先使用@XmlElement的name属性
        objectMapper.setPropertyNamingStrategy(new PropertyNamingStrategy() {
            @Override
            public String nameForField(MapperConfig<?> config, AnnotatedField field, String defaultName) {
                XmlElement xmlElement = field.getAnnotation(XmlElement.class);
                if (xmlElement != null && !xmlElement.name().isEmpty()) {
                    return xmlElement.name();
                }
                return defaultName;
            }

            @Override
            public String nameForGetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName) {
                XmlElement xmlElement = method.getAnnotation(XmlElement.class);
                if (xmlElement != null && !xmlElement.name().isEmpty()) {
                    return xmlElement.name();
                }
                return super.nameForGetterMethod(config, method, defaultName);
            }
        });

        converter.setObjectMapper(objectMapper);
        return converter;
    }
}

此配置会强制Jackson在序列化/反序列化时，优先使用@XmlElement指定的name作为JSON字段名，没有该注解的字段则沿用默认字段名，完全兼容现有XML和JSON的解析逻辑。

验证效果 #

配置完成后，测试JSON请求/响应会自动使用@XmlElement的name属性，与XML的字段名保持一致，无需修改任何POJO或控制器，保证了向后兼容性。

内容的提问来源于stack exchange，提问作者Alapati Srikanth Chowdary