JDEdwards升级后SOAP Literal WSDL请求体为空问题排查

我之前处理过好几起JDEdwards升级后SOAP接口调用异常的情况，结合你描述的问题——升级后WSDL只剩Literal定义、调用createSalesOrder2C只返回空标签，咱们可以从这几个方向排查和解决：

1. 先确认WSDL的XSD定义是否真的缺失（或被外部引用） #

Literal编码模式下，SOAP客户端完全依赖WSDL里的XSD结构来生成请求体。升级后的JDEdwards有时候会把XSD定义抽离到外部文件中，而不是内嵌在WSDL里。你可以打开新WSDL查看<types>节点，看看有没有类似这样的引用：

<xsd:import namespace="http://your-jde-namespace" schemaLocation="external_schema.xsd"/>

如果有，要确保这些外部XSD能被PHP客户端访问到：

• 可以手动下载XSD文件到本地，修改WSDL里的schemaLocation指向本地路径
• 或者检查服务器是否允许你的PHP服务访问这些外部XSD的URL

2. 手动构造严格匹配接口要求的参数结构 #

因为WSDL缺失结构定义，WSSoapClient2无法自动映射参数，这时候你需要对照JDEdwards官方的createSalesOrder2C接口文档，手动构建符合要求的关联数组。举个例子：

// 严格按照接口的XSD结构构造参数
$orderParams = [
    'SalesOrderHeader' => [
        'DocumentType' => 'SO',
        'OrderNumber' => 'ORD-2024-001',
        'CustomerNumber' => 'CUST-1001',
        // 其他必填头部字段
    ],
    'SalesOrderLines' => [
        'SalesOrderLine' => [
            [
                'ItemCode' => 'ITEM-007',
                'Quantity' => 5,
                'UnitPrice' => 99.99,
                // 其他行项目字段
            ]
        ]
    ]
];

初始化客户端时，一定要明确指定Literal模式：

$client = new WSSoapClient2('path/to/modified_wsdl.wsdl', [
    'soap_version' => SOAP_1_1,
    'style' => SOAP_LITERAL,
    'use' => SOAP_LITERAL,
    'trace' => true, // 开启跟踪，方便查看生成的请求体
]);

调用接口后如果失败，打印请求体确认问题：

try {
    $response = $client->createSalesOrder2C($orderParams);
} catch (SoapFault $e) {
    echo "生成的请求体:\n" . $client->__getLastRequest();
    echo "\n错误信息:\n" . $e->getMessage();
}

3. 修正命名空间匹配问题 #

空标签的常见原因之一是命名空间不匹配。升级后的WSDL可能更新了目标命名空间（比如原来的ns1指向的URL变了），你需要：

• 检查WSDL里的目标命名空间，确保参数数组的每个节点都关联正确的命名空间
• 或者手动添加SOAP Header来指定命名空间：

$targetNs = 'http://new-jde-namespace.com'; // 替换为WSDL里的实际命名空间
$headerParams = [/* 头部参数如果有的话 */];
$soapHeader = new SoapHeader($targetNs, 'RequestHeader', $headerParams);
$client->__setSoapHeaders($soapHeader);

4. 手动构造完整XML请求体直接发送 #

如果上面的方法都不行，你可以直接构造符合要求的SOAP XML请求，用__doRequest()方法发送，绕开客户端自动生成的问题：

$soapXml = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://new-jde-namespace.com">
    <soapenv:Header/>
    <soapenv:Body>
        <ns1:createSalesOrder2C>
            <SalesOrderHeader>
                <DocumentType>SO</DocumentType>
                <OrderNumber>ORD-2024-001</OrderNumber>
                <CustomerNumber>CUST-1001</CustomerNumber>
            </SalesOrderHeader>
            <SalesOrderLines>
                <SalesOrderLine>
                    <ItemCode>ITEM-007</ItemCode>
                    <Quantity>5</Quantity>
                    <UnitPrice>99.99</UnitPrice>
                </SalesOrderLine>
            </SalesOrderLines>
        </ns1:createSalesOrder2C>
    </soapenv:Body>
</soapenv:Envelope>';

$response = $client->__doRequest(
    $soapXml,
    $client->__getLocation(),
    $client->__getSoapAction(),
    1 // SOAP版本，1对应SOAP 1.1
);
// 解析响应
$parsedResponse = $client->__parseResponse($response);

5. 修复WSDL的结构缺失 #

如果对比新旧WSDL发现新WSDL确实遗漏了createSalesOrder2C的请求结构定义，你可以尝试把旧WSDL里对应的<types>部分（包含请求参数的XSD）复制到新WSDL中，保存为本地文件后再使用。注意要确保命名空间、接口名称完全匹配，避免冲突。

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