SOAP响应中@XmlElement指定的元素名变为小写问题如何解决

问题原因 #

• 注解包导入错误：@XmlElement 注解导入的不是JAXB规范的包（javax.xml.bind.annotation.XmlElement 或 jakarta.xml.bind.annotation.XmlElement），而是其他序列化框架的同名注解，导致JAXB/SOAP框架无法识别配置的自定义节点名
• 序列化框架未识别JAXB注解：当前项目的SOAP服务或XML序列化层用的是Jackson XML等非JAXB原生序列化组件，默认没有开启JAXB注解适配，你配置的@XmlElement(name = "PingResult")没有生效，框架直接按照JavaBean属性名规则把getPingResult对应的属性序列化为小写开头的pingResult节点
• JAXB访问策略配置冲突：PingResponse类没有显式配置@XmlAccessorType注解，默认值为XmlAccessType.PUBLIC_MEMBER，如果同时在字段和getter上重复配置了注解，或者框架优先读取字段名做序列化，也会出现节点名不符合预期的问题
• 部分老旧SOAP框架（如Axis1.x）本身对JAXB注解支持不完善，会忽略方法上的注解直接用属性名生成节点

解决方案 #

• 先校验注解导入是否正确，确保导包是JAXB规范的包：
  旧版本Java EE用import javax.xml.bind.annotation.XmlElement;
  新版本Jakarta EE用import jakarta.xml.bind.annotation.XmlElement;
• 显式给PingResponse类加上@XmlAccessorType注解，指定访问策略为仅扫描getter方法上的注解，避免冲突：

  @XmlRootElement(name = "PingResponse")
  @XmlAccessorType(XmlAccessType.PROPERTY) // 仅识别getter/setter上的注解
  public class PingResponse implements java.io.Serializable {
      private String pingResult;
  
      @XmlElement(name = "PingResult")
      public String getPingResult() {
          return pingResult;
      }
  
      public void setPingResult(String pingResult) {
          this.pingResult = pingResult;
      }
  }
  

  如果你想把注解放到字段上，就把访问策略改成XmlAccessType.FIELD，然后把@XmlElement注解放到private String pingResult;上面即可
• 如果你的项目用了Jackson XML做序列化（比如Spring Boot Web Services默认配置），需要手动开启JAXB注解支持，给Jackson的XmlMapper注册JAXB注解模块：

  @Bean
  public XmlMapper xmlMapper() {
      XmlMapper xmlMapper = new XmlMapper();
      xmlMapper.registerModule(new JaxbAnnotationModule());
      return xmlMapper;
  }
  

• 如果以上方案都不生效，可以直接用Jackson原生的@JacksonXmlProperty注解显式指定节点名，优先级更高：

  @JacksonXmlProperty(localName = "PingResult")
  public String getPingResult() {
      return pingResult;
  }
  

• 如果你用的是老旧的Axis1.x等不支持JAXB的SOAP框架，需要修改框架的序列化配置，或者直接自定义SOAP响应序列化逻辑。

内容的提问来源于stack exchange，提问作者A.J