如何正确使用Node.js SOAP模块？调用接口返回ECONNRESET错误如何解决？

ECONNRESET错误产生原因 #

该错误本质是TCP连接被远程SOAP服务端非正常强制中断，没有完成正常的四次挥手流程，常见触发场景如下：

• 远程SOAP服务端本身运行不稳定，或主动切断了空闲时间超过阈值的TCP连接
• 网络层面存在拦截：防火墙、安全组、代理规则拦截了你的请求，或当前运行代码的环境没有访问目标SOAP服务端口的权限
• SOAP请求格式不符合服务端要求：缺少必要的认证信息、请求头配置、参数结构/命名空间错误，服务端收到非法请求后直接断连，没有返回错误报文
• 你的请求频率超过了服务端的限流阈值，被服务端主动拒绝连接

处理方案 #

• 先调整SOAP客户端配置，增加超时、日志和连接规则，排查请求层面的问题，参考修改后的代码：

const soapOptions = {
  timeout: 10000, // 设置10秒超时，避免长时间无响应触发服务端断连
  forever: false, // 禁用TCP连接复用，避免复用已被服务端切断的空闲连接
  escapeXML: true
}
soap.createClient(url, soapOptions, function(err, client) {
  // 开启请求/响应/错误日志，可直接核对请求XML格式是否符合服务端要求
  client.on('request', (xml) => console.log('请求XML内容：', xml))
  client.on('response', (xml) => console.log('响应XML内容：', xml))
  client.on('soapError', (err) => console.log('SOAP协议层面错误：', err))

  if(err) {
     res.status(500);
     return res.send(err);
  }

  client.GetMemberPIN({pUserName: 'r'}, function(error, result) {
    if(error) {
      res.status(500);
      return res.send(error)
    }
    return res.send(result);
  });
});

• 先排查网络连通性：在代码运行环境用curl、Postman等工具直接请求目标SOAP服务的WSDL地址，手动构造GetMemberPIN接口的请求报文发送，确认服务端本身可访问、参数正确时能返回正常响应，排除网络、权限、服务端故障类问题
• 若服务端要求身份认证，需要补充WS-Security配置，示例如下：

client.setSecurity(new soap.WSSecurity('你的用户名', '你的密码'));

• 若当前网络需要代理才能访问外部服务，在创建客户端的配置中补充代理参数：

const soapOptions = {
  proxy: 'http://代理地址:代理端口',
  timeout: 10000
}

• 针对偶发的网络波动类断连，可增加指数退避的重试逻辑，避免单次请求失败直接抛出错误

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