如何使用npm soap库加载本地WSDL文件创建SOAP客户端并调用API？

问题排查与修正方案 #

1. 本地WSDL文件URL格式错误 #

你当前使用的file:/${wsdlPath}不符合标准文件URL规范，不同操作系统的正确格式存在差异：

• Unix/Linux/macOS：file://绝对路径
• Windows：file:///绝对路径（需三个斜杠）

可以通过path.resolve生成绝对路径，再转换为跨平台兼容的标准file URL。

2. 确保WSDL依赖文件可访问 #

若你的WSDL中引用了其他XSD或WSDL文件，需确保这些文件的路径在本地能被正确解析（可使用相对路径或绝对路径）。

修正后的代码示例 #

const soap = require('soap');
const path = require('path');

async function testRequest() {
    // 生成WSDL文件的绝对路径
    const wsdlAbsolutePath = path.resolve(__dirname, 'wsdl/webservice/wsdl/test.wsdl');
    // 转换为标准file URL（兼容Windows反斜杠）
    const wsdlUrl = `file://${wsdlAbsolutePath.replace(/\\/g, '/')}`;
    console.log("WSDL URL:", wsdlUrl);

    const args = {
        capability: {
            release: {
                version: {
                    major: 1,
                    minor: 0
                }
            },
            authentication: 'md5-digest'
        }
    };

    try {
        // 创建SOAP客户端
        const client = await soap.createClientAsync(wsdlUrl);
        
        // 可选：打印所有可用API方法，确认testRequest是否存在
        console.log("可用方法:", Object.keys(client));
        
        // 调用目标API
        const response = await client.testRequestAsync(args);
        const result = response[0];
        console.log("testRequest响应: ", result);
        return result;
    } catch (error) {
        console.error("请求错误:", error.message);
        console.error("错误详情:", error);
        throw new Error('testRequest调用失败: ' + error.message);
    }
}

// 执行测试
testRequest().catch(err => console.error(err));

额外调试技巧 #

• 启用soap库调试日志，查看完整请求响应细节：

  soap.setLog(true);
  

• 使用SoapUI等工具验证本地WSDL文件的有效性，确认API方法定义正确。

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