调用SOAP Client遇soapenv:Client错误：模板与请求参数不一致

问题现象 #

调用SOAP接口时遇到两个矛盾的错误：

• 不添加Params参数时，触发soapenv:Client错误，提示**"Template Parameters inconsistent with request parameters"**
• 手动添加Params后，又提示**"VAR01 required element missing"**

原始请求示例 #

正常工作的XML请求

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:abs="http://xx.yz.com/">
<soapenv:Header/>
<soapenv:Body>
<abs:Notification>
   <ClientId>xxxxx</ClientId>
   <ClientAuthorization>xxxx</ClientAuthorization>
   <TemplateId>xxxxx</TemplateId>
   <Recipients>
      <Recipient>
         <NationalOrIqamaId>xxxxxx</NationalOrIqamaId>
         <Language>xxxx</Language>
         <Params>
            <Param>
               <Name>xxxxx</Name>
               <Value>xxxx</Value>
            </Param>
            <Param>
               <Name>xxxx</Name>
               <Value>xxxxx</Value>
            </Param>
            <Param>
               <Name>xxxxx</Name>
               <Value>xxxxx</Value>
            </Param>
         </Params>
      </Recipient>
       </Recipients>
     </abs:Notification>
    </soapenv:Body>
</soapenv:Envelope>

报错的PHP代码

$wsdl           = 'xxxxx?wsdl';
$endpoint       = 'xxxx';
$certificate    = 'xxxxxx.pem';
$password       = 'xxxx';

$options = array(
    'location'      => $endpoint,
    'keep_alive'    => true,
    'trace'         => true,
    'local_cert'    => $certificate,
    'passphrase'    => $password,
    'cache_wsdl'    => WSDL_CACHE_NONE,
);
$params = new stdClass();
$params->ClientId = xxxxxx;
$params->ClientAuthorization="xxxxxxx";
$params->TemplateId="xxxxx";
$params->Recipients=array(
    "Recipient"=>array(
        "NationalOrIqamaId"=>xxxx,
        "Language"=>"xxxxx",
    )
);
try{
    var_dump($soapClient ->SubmitRequest($params));
} catch(SoapFault $fault) {
    trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
}

问题原因 #

核心是PHP参数结构与SOAP XML的层级不匹配：

1. 原始XML中Params是Recipient的直接子节点，且包含多个Param子元素
2. 原PHP代码要么完全缺失Params节点，要么添加时结构错误，导致接口无法识别参数（比如VAR01对应的参数名没正确映射）

修正后的PHP代码 #

$wsdl = 'xxxxx?wsdl';
$endpoint = 'xxxx';
$certificate = 'xxxxxx.pem';
$password = 'xxxx';

$options = array(
    'location' => $endpoint,
    'keep_alive' => true,
    'trace' => true,
    'local_cert' => $certificate,
    'passphrase' => $password,
    'cache_wsdl' => WSDL_CACHE_NONE,
);

try {
    // 补充SoapClient实例化（原代码遗漏）
    $soapClient = new SoapClient($wsdl, $options);

    $params = new stdClass();
    $params->ClientId = 'xxxxx';
    $params->ClientAuthorization = 'xxxxxxx';
    $params->TemplateId = 'xxxxx';
    
    // 严格按照XML层级构建Recipient及Params
    $params->Recipients = array(
        "Recipient" => array(
            "NationalOrIqamaId" => 'xxxx',
            "Language" => 'xxxxx',
            "Params" => array(
                "Param" => array(
                    // 每个Param对应XML中的<Param>节点，Name必须与模板要求的参数名完全匹配（比如VAR01）
                    array(
                        "Name" => 'VAR01', // 替换为模板要求的参数名
                        "Value" => '对应的值'
                    ),
                    array(
                        "Name" => 'xxxxx',
                        "Value" => 'xxxx'
                    ),
                    array(
                        "Name" => 'xxxx',
                        "Value" => 'xxxxx'
                    )
                )
            )
        )
    );

    $response = $soapClient->SubmitRequest($params);
    var_dump($response);

    // 可选：打印生成的XML请求，对比原始XML验证结构
    // echo $soapClient->__getLastRequest();
} catch(SoapFault $fault) {
    trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
}

关键修正说明 #

1. 补充SoapClient实例化：原代码直接使用$soapClient但未创建对象，导致调用失败
2. 匹配XML层级结构：Params必须作为Recipient的子节点，且内部用Param数组包裹多个参数对象
3. 参数名严格匹配：Param中的Name字段必须与模板要求的参数名完全一致（比如报错中的VAR01，必须在Name中填写VAR01）
4. 验证请求结构：开启trace后，通过__getLastRequest()打印生成的XML，与原始正确XML对比，快速定位结构差异

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