最简Workday SOAP请求失败：Client.validationError含义解析

问题场景 #

我使用一个SOAP请求测试Workday服务可用性，所用的用户名、密码和请求端点在同端点的其他业务请求中可正常工作，但当前请求返回了SOAP-ENV:Client.validationError错误，需要明确该错误是认证失败还是XML格式/内容不被认可。

请求内容 #

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope> 
   xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
   xmlns:bsvc="urn:com.workday/bsvc"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
   <!-- xmlns:cus="urn:com.workday/tenants/super/data/custom"> -->
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="1">
         <wsse:UsernameToken>
            <wsse:Username>ISU_Get_Worker_Photo@mycompany_preview</wsse:Username>
            <wsse:Password
               Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">xxxxxxxxxx</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <bsvc:Change_Work_Contact_Information_Request bsvc:version="v42.0">
         <bsvc:Change_Work_Contact_Information_Data>
            <!--Optional:-->
            <bsvc:Person_Reference bsvc:Descriptor="?">
               <!--Zero or more repetitions:-->
               <bsvc:ID bsvc:type="Employee_ID">5534</bsvc:ID>
            </bsvc:Person_Reference>
            
            <bsvc:Person_Contact_Information_Data>
            
            </bsvc:Person_Contact_Information_Data>
         </bsvc:Change_Work_Contact_Information_Data>
      </bsvc:Change_Work_Contact_Information_Request>
   </soapenv:Body>
</soapenv:Envelope>

请求端点 #

https://wd5-impl-services1.workday.com/ccx/service/mycompany_preview/Human_Resources/v42.0

返回响应 #

<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <SOAP-ENV:Fault xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wd="urn:com.workday/bsvc">
            <faultcode>SOAP-ENV:Client.validationError</faultcode>
            <faultstring>Invalid request</faultstring>
        </SOAP-ENV:Fault>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

错误含义解析 #

• 不是认证失败：Workday的认证失败会返回明确的错误码（如InvalidCredentials），且你已确认同账号在同端点的其他请求正常，排除认证问题。
• 属于客户端请求验证错误：该错误说明请求的XML格式或内容不符合Workday服务的校验规则，结合你的请求，存在两个明显问题：
  1. XML格式错误：<soapenv:Envelope>标签的写法错误，所有命名空间属性必须放在标签的起始标签内，不能单独写在标签闭合后。正确写法应为：

     <soapenv:Envelope 
        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:bsvc="urn:com.workday/bsvc"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
     

  2. 请求内容不完整：<bsvc:Person_Contact_Information_Data>节点为空，Change_Work_Contact_Information_Request要求该节点包含具体的修改内容（如邮箱、电话等），空节点不符合Workday的业务规则校验。

排查建议 #

1. 先修正Envelope标签的格式错误，确保所有命名空间属性都在起始标签内
2. 为Person_Contact_Information_Data添加至少一个合法的联系人信息字段（例如<bsvc:Email_Address_Data>节点）
3. 使用Workday API测试工具验证修正后的请求，确认格式和内容合规

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