Laravel中调用API的SOAP请求失败问题排查

你Laravel代码的核心问题是：直接将wsseopts数组传给SoapHeader无法生成符合WS-Security规范的请求头结构。Node.js的soap.WSSecurity会自动处理Nonce生成、命名空间嵌套、密码格式封装等细节，但PHP原生SoapHeader只会把数组转换成简单XML节点，完全不符合服务端期望的WS-Security格式。

推荐两种实现方式，优先选择现成库（避免手动构造XML的繁琐和错误）：

方式一：使用WS-Security专用库（推荐） #

使用robrichards/wse-php库，它能完全模拟Node.jssoap.WSSecurity的行为，自动生成合规的WS-Security头。

1. 安装库

composer require robrichards/wse-php

2. 替换你的代码：

use RobRichards\WsePhp\WSSESoap;

// 初始化SoapClient，无需配置login/password（用WS-Security头替代HTTP认证）
$client = new SoapClient($url, [
    'trace' => true // 开启trace方便调试请求内容
]);

// 初始化WS-Security处理实例
$wsse = new WSSESoap($client);

// 添加用户名令牌，完全匹配Node.js的配置
$wsse->addUserToken($login, $password, [
    'passwordType' => WSSESoap::PASSWORD_TEXT,
    'nonce' => true,       // 对应hasNonce=true
    'created' => false     // 对应hasTimeStamp=false
]);

// 应用Security头到请求
$wsse->signSoapDoc();

try {
    $response = $client->getFunction([
        'token' => $token
    ]);
    
    $response2 = $client->getFunctionSecond([
        // 你的参数
    ]);
} catch (\SoapFault $e) {
    // 打印请求内容，对比Node.js的请求差异
    echo "请求内容:\n" . $client->__getLastRequest() . "\n";
    echo "错误信息: " . $e->getMessage();
}

方式二：手动构造WS-Security XML头 #

如果不想引入第三方库，可以手动构造符合规范的XML结构，再传给SoapHeader：

// 生成16字节随机Nonce（base64编码）
$nonce = base64_encode(random_bytes(16));

// 构造WS-Security规范的XML内容
$wsseXml = <<<XML
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
    <wsse:UsernameToken>
        <wsse:Username>$login</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">$password</wsse:Password>
        <wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">$nonce</wsse:Nonce>
    </wsse:UsernameToken>
</wsse:Security>
XML;

// 将XML转换成DOM节点，避免被当作纯文本
$dom = new DOMDocument();
$dom->loadXML($wsseXml);

// 创建正确的SoapHeader
$wsseHeader = new SoapHeader(
    'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd',
    'Security',
    $dom->documentElement,
    false
);

$client = new SoapClient($url, [
    'trace' => true
]);

$client->__setSoapHeaders($wsseHeader);

try {
    $response = $client->getFunction([
        'token' => $token
    ]);
} catch (\SoapFault $e) {
    echo "请求内容:\n" . $client->__getLastRequest() . "\n";
    echo "错误信息: " . $e->getMessage();
}

开启trace=true后，用$client->__getLastRequest()获取PHP发送的SOAP请求，和Node.js端的请求（可通过抓包或soap库调试日志获取）对比XML结构，就能快速定位差异点。

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