Spring Boot调用SOAP API遇版本错误，无WSDL有Java对象求方案

一、“版本错误”的核心原因及排查 #

你直接以<pricing>标签作为请求根节点不符合SOAP规范，SOAP请求必须包含标准的SOAP信封（Envelope），这大概率是触发“版本错误”的核心原因。具体排查方向：

• SOAP版本与信封结构不匹配：
  SOAP 1.1和1.2的信封命名空间不同，必须严格匹配API要求：
  • SOAP 1.1信封：

    <?xml version="1.0" encoding="UTF-8"?>
    <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
      <soap:Body>
        <pricing><!-- 你的业务请求内容 --></pricing>
      </soap:Body>
    </soap:Envelope>
    

  • SOAP 1.2信封：

    <?xml version="1.0" encoding="UTF-8"?>
    <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
      <soap:Body>
        <pricing><!-- 你的业务请求内容 --></pricing>
      </soap:Body>
    </soap:Envelope>
    

• 请求头Content-Type错误：
  SOAP 1.1对应text/xml; charset=utf-8，SOAP 1.2对应application/soap+xml; charset=utf-8，头信息不符也会触发版本类错误。
• 业务标签缺少命名空间：
  <pricing>可能需要指定API要求的命名空间，比如<ns1:pricing xmlns:ns1="http://your-api-domain.com/pricing/v1">，缺失会被判定为格式非法。

二、生成合规XML请求的两种方法 #

方法1：手动拼接SOAP信封（快速验证） #

先把你的Java对象序列化为<pricing>片段，再包裹标准SOAP信封。以JAXB为例：

// 序列化业务对象为XML片段
JAXBContext jaxbContext = JAXBContext.newInstance(Pricing.class);
Marshaller marshaller = jaxbContext.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

StringWriter sw = new StringWriter();
marshaller.marshal(yourPricingObject, sw);
String pricingXml = sw.toString();

// 拼接完整SOAP请求
String fullSoapRequest = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
                         "<soap:Envelope xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">" +
                         "<soap:Body>" +
                         pricingXml +
                         "</soap:Body>" +
                         "</soap:Envelope>";

方法2：用Spring WebServiceTemplate（生产环境推荐） #

Spring的WebServiceTemplate会自动处理SOAP信封的生成，无需手动拼接：

1. 配置SOAP模板：

@Bean
public SaajSoapMessageFactory soapMessageFactory() {
    SaajSoapMessageFactory factory = new SaajSoapMessageFactory();
    // 根据API要求设置SOAP版本：SOAP_11或SOAP_12
    factory.setSoapVersion(SoapVersion.SOAP_11);
    return factory;
}

@Bean
public WebServiceTemplate webServiceTemplate(SaajSoapMessageFactory soapMessageFactory) {
    WebServiceTemplate template = new WebServiceTemplate(soapMessageFactory);
    // 设置API的端点地址
    template.setDefaultUri("http://your-api-endpoint.com/soap/service");
    return template;
}

2. 发送请求：

@Autowired
private WebServiceTemplate webServiceTemplate;

public void sendRequest(Pricing pricing) {
    // 确保Pricing类添加了JAXB注解以匹配XML结构
    Object response = webServiceTemplate.marshalSendAndReceive(pricing);
    // 处理响应逻辑
}

给Pricing类添加JAXB注解匹配API要求：

@XmlRootElement(name = "pricing", namespace = "http://your-api-domain.com/pricing/v1")
public class Pricing {
    @XmlElement(name = "product-id")
    private String productId;
    // 其他字段及getter/setter
}

三、无WSDL但有Java对象的可行性 #

完全可行，但需要注意：

• 确保Java对象的字段名、注解、结构完全匹配API要求的XML格式（包括标签大小写、命名空间、字段顺序），可通过对比API提供的示例请求验证。
• 必须明确API的SOAP版本、端点地址、请求头参数，这些信息可以从API文档或正常调用的抓包结果中获取。
• 后续API更新时，需要手动同步Java对象结构，维护成本比用WSDL自动生成代码略高。

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