Spring Boot 3 HTTP请求中application/xml支持问题排查

服务端问题（JAXB注解失效、XML标签不符） #

核心原因 #

Spring Boot 3.x默认的MappingJackson2XmlHttpMessageConverter未启用Jakarta JAXB注解支持，且Jackson XML模块需适配Jakarta生态的注解包。

解决步骤 #

1. 调整依赖（全替换为Jakarta版本）

   <!-- Jackson XML序列化支持 -->
   <dependency>
       <groupId>com.fasterxml.jackson.dataformat</groupId>
       <artifactId>jackson-dataformat-xml</artifactId>
   </dependency>
   <!-- Jakarta JAXB API（Jackson识别注解依赖） -->
   <dependency>
       <groupId>jakarta.xml.bind</groupId>
       <artifactId>jakarta.xml.bind-api</artifactId>
   </dependency>
   <!-- JAXB实现类（可选EclipseLink或GlassFish实现） -->
   <dependency>
       <groupId>org.eclipse.persistence</groupId>
       <artifactId>eclipselink</artifactId>
       <version>4.0.2</version>
   </dependency>
   

2. 配置Jackson XML转换器，启用JAXB注解支持
   创建配置类自定义转换器：

   import com.fasterxml.jackson.dataformat.xml.XmlMapper;
   import com.fasterxml.jackson.module.jakarta.xmlbind.JakartaXmlBindAnnotationModule;
   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
   import org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter;
   
   @Configuration
   public class XmlMessageConverterConfig {
       @Bean
       public MappingJackson2XmlHttpMessageConverter xmlHttpMessageConverter() {
           XmlMapper xmlMapper = new XmlMapper();
           // 注册Jakarta JAXB注解解析模块
           xmlMapper.registerModule(new JakartaXmlBindAnnotationModule());
           return new MappingJackson2XmlHttpMessageConverter(xmlMapper);
       }
   }
   

3. 修正DTO的注解包路径
   将原javax.xml.bind.annotation下的注解替换为Jakarta版本：

   import jakarta.xml.bind.annotation.XmlRootElement;
   import jakarta.xml.bind.annotation.XmlElement;
   
   @XmlRootElement(name = "transaction")
   public class TransactionDto {
       @XmlElement(name = "orderID")
       private String orderId;
   
       // getter、setter方法省略
   }
   

客户端问题（WebClient无法反序列化XML，抛出UnsupportedMediaTypeException） #

核心原因 #

手动配置Jaxb2Encoder/Jaxb2Decoder时缺少JAXB实现类，且WebClient未正确绑定XML媒体类型的转换器。

解决步骤 #

1. 确保依赖完整（同服务端的Jakarta JAXB依赖）
2. 正确配置WebClient的消息转换器
   方案一：使用Jackson XML转换器（推荐，和服务端序列化逻辑一致）

   import com.fasterxml.jackson.dataformat.xml.XmlMapper;
   import com.fasterxml.jackson.module.jakarta.xmlbind.JakartaXmlBindAnnotationModule;
   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
   import org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter;
   import org.springframework.web.reactive.function.client.WebClient;
   
   @Configuration
   public class WebClientConfig {
       @Bean
       public WebClient xmlWebClient() {
           XmlMapper xmlMapper = new XmlMapper();
           xmlMapper.registerModule(new JakartaXmlBindAnnotationModule());
           MappingJackson2XmlHttpMessageConverter converter = new MappingJackson2XmlHttpMessageConverter(xmlMapper);
   
           return WebClient.builder()
                   .codecs(configurer -> configurer.customCodecs().register(converter))
                   .build();
       }
   }
   

   方案二：使用原生JAXB转换器

   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
   import org.springframework.http.converter.xml.Jaxb2XmlDecoder;
   import org.springframework.http.converter.xml.Jaxb2XmlEncoder;
   import org.springframework.web.reactive.function.client.WebClient;
   
   @Configuration
   public class WebClientConfig {
       @Bean
       public WebClient xmlWebClient() {
           return WebClient.builder()
                   .codecs(configurer -> {
                       configurer.defaultCodecs().jaxb2Decoder(new Jaxb2XmlDecoder());
                       configurer.defaultCodecs().jaxb2Encoder(new Jaxb2XmlEncoder());
                   })
                   .build();
       }
   }
   

3. 调用接口时明确指定接收媒体类型

   TransactionDto result = webClient.get()
           .uri("http://localhost:8080/transaction")
           .accept(MediaType.APPLICATION_XML)
           .retrieve()
           .bodyToMono(TransactionDto.class)
           .block();
   

额外注意事项 #

• 彻底清理项目中所有javax.*相关依赖，确保仅使用jakarta.*包
• 若自定义了WebMvcConfigurationSupport，需手动添加XML转换器；建议改用@WebMvcConfigurer扩展配置，避免覆盖Spring Boot默认的消息转换器

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