Java调用SOAP API遇tenantId非空异常，求排查思路

核心问题 #

你的SOAP请求存在两个关键错误，导致服务器无法正确解析tenantId参数：

• 请求结构不符合API要求：SOAP的Connect方法需要将所有参数包裹在<ns:Connect>根节点下，你直接把tenantId、userName等元素放在<SOAP-ENV:Body>下，服务器无法识别这些参数归属Connect方法，因此判定tenantId未传入。
• 参数名错误：你重复添加了<ns:userName>节点，第二个节点应为<ns:password>。

修正后的代码 #

重点修改createSoapEnvelope方法，构建符合API要求的请求结构：

private static void createSoapEnvelope(SOAPMessage soapMessage) throws SOAPException {
    SOAPPart soapPart = soapMessage.getSOAPPart();

    String myNamespace = "ns";
    String myNamespaceURI = "SaaS.Services";

    // SOAP Envelope
    SOAPEnvelope envelope = soapPart.getEnvelope();
    envelope.addNamespaceDeclaration(myNamespace, myNamespaceURI);

    // SOAP Body
    SOAPBody soapBody = envelope.getBody();
    // 先创建Connect方法节点，所有参数作为其子元素
    SOAPElement connectElement = soapBody.addChildElement("Connect", myNamespace);
    
    // 添加各个参数到Connect节点下
    SOAPElement tenantIdElem = connectElement.addChildElement("tenantId", myNamespace);
    tenantIdElem.addTextNode("virimadev.trysaasit.com");
    
    SOAPElement userNameElem = connectElement.addChildElement("userName", myNamespace);
    userNameElem.addTextNode("Alan.Taylor");
    
    SOAPElement passwordElem = connectElement.addChildElement("password", myNamespace);
    passwordElem.addTextNode("你的实际密码"); // 替换为真实密码
    
    SOAPElement roleElem = connectElement.addChildElement("role", myNamespace);
    roleElem.addTextNode("Admin");
}

修正后的请求示例 #

修改后生成的SOAP请求结构如下，服务器可正确识别所有参数：

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="SaaS.Services">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns:Connect>
            <ns:tenantId>virimadev.trysaasit.com</ns:tenantId>
            <ns:userName>Alan.Taylor</ns:userName>
            <ns:password>你的实际密码</ns:password>
            <ns:role>Admin</ns:role>
        </ns:Connect>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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