使用Savon调用第三方SOAP接口遇连接重置问题求助

1. 先确认基础网络连通性 #

• 测试目标端口可达性：

  nc -zv anotherendpoint.com 443
  # 或使用telnet
  telnet anotherendpoint.com 443
  

  如果连接失败，说明网络层面存在问题（如防火墙拦截、路由故障、目标端口未开放），优先解决网络连通问题。
• 关闭本地代理、VPN或防火墙，排除这类工具对连接的干扰。

2. 排查SSL/TLS握手细节 #

• 用OpenSSL手动模拟SSL握手，获取详细错误信息：

  # 需要客户端证书验证的场景
  openssl s_client -connect anotherendpoint.com:443 -cert /path/to/cert.crt -key /path/to/key.key -passin pass:somePassword
  # 仅验证服务器证书信任链的场景
  openssl s_client -connect anotherendpoint.com:443 -CAfile /path/to/root_ca.crt
  

  观察输出中的握手阶段提示：verify return:1表示信任正常，verify return:20说明证书链无法验证，需确认根CA证书是否正确。
• 注意：Ruby程序默认不会读取OSX钥匙串的信任证书，需在Savon配置中显式指定CA证书：

  client = Savon.client(
    # 其他配置项...
    ssl_ca_cert_file: '/path/to/root_ca.crt' # 替换为实际根CA证书路径
  )
  

3. 验证证书与密钥的有效性及匹配性 #

• 检查证书和私钥是否匹配：

  # 提取证书公钥哈希
  openssl x509 -noout -modulus -in /path/to/cert.crt | openssl md5
  # 提取私钥公钥哈希
  openssl rsa -noout -modulus -in /path/to/key.key -passin pass:somePassword | openssl md5
  

  两个输出的哈希值必须完全一致，否则证书与密钥不匹配。
• 尝试使用PFX文件配置：对方提供的.pfx文件通常包含完整证书链和密钥，直接使用可避免证书链缺失问题：

  client = Savon.client(
    # 其他配置项...
    ssl_pfx: File.read('/path/to/cert.pfx'),
    ssl_pfx_password: 'somePassword' # PFX文件对应的密码
  )
  

4. 确认端点与WSDL的一致性 #

• 对比WSDL中定义的端点和你指定的endpoint参数，确保路径完全一致（比如WSDL中的端点可能是https://anotherendpoint.com/soap/service，而非单纯域名）。
• 用curl测试端点的基本响应：

  curl -v -X POST https://anotherendpoint.com
  

  如果返回404，说明端点路径错误；若仍出现连接重置，问题大概率在网络或SSL层面。

5. 排查依赖版本兼容性 #

• 当前使用的httpclient 2.8.3与openssl 3.0.1可能存在兼容性问题，尝试更新依赖：

  bundle update savon httpclient
  

  或临时降级openssl版本到2.x，观察问题是否解决。

6. 联系服务端获取日志 #

连接重置多数是服务端主动断开连接，可能原因包括：客户端IP被封禁、请求未携带有效证书、请求格式不符合要求等。如果能联系对方获取服务端的访问日志或错误日志，可快速定位问题根源。

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