无法注册Self Hosted Integration Runtime，请求故障排查方案

问题描述 #

无法在本地机器上注册Self Hosted Integration Runtime，注册时提示错误：

The Integration Runtime (Self-hosted) node has encountered an error during registration. Unable to determine the Integration Runtime (Self-hosted) node status. Confirm that the Integration Runtime (Self-hosted) Host Service is running, and a valid SSL certificate has been specified.

日志详情 #

Failed to get service token from ADF service with key IR@a68e529a-ae7a-724fff69aad6@xxxDataFactory@ServiceEndpoint=xxxdatafactory.eastus.datafactory.azure.net@****************** and time cost is: 3.8236143 seconds, the error code is: UnexpectedFault, activityId is: 40797b25-a932-4e79-86dd-ccbcd4d7cf7f and detailed error message is An error occurred while sending the request.
The underlying connection was closed: An unexpected error occurred on a send.
Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host.
An existing connection was forcibly closed by the remote host

错误堆栈信息 #

{
  "ClassName": "System.Net.Http.HttpRequestException",
  "Message": "An error occurred while sending the request.",
  "Data": null,
  "InnerException": {
    "ClassName": "System.Net.WebException",
    "Message": "The underlying connection was closed: An unexpected error occurred on a send.",
    "Data": null,
    "InnerException": {
      "ClassName": "System.IO.IOException",
      "Message": "Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host.",
      "Data": null,
      "InnerException": {
        "NativeErrorCode": 10054,
        "ClassName": "System.Net.Sockets.SocketException",
        "Message": "An existing connection was forcibly closed by the remote host",
        "Data": null,
        "InnerException": null,
        "HelpURL": null,
        "StackTraceString": "   at System.Net.Sockets.Socket.EndReceive(IAsyncResult asyncResult)\r\n   at System.Net.Sockets.NetworkStream.EndRead(IAsyncResult asyncResult)",
        "RemoteStackTraceString": null,
        "RemoteStackIndex": 0,
        "Source": "System",
        "WatsonBuckets": null
      },
      "HelpURL": null,
      "StackTraceString": "   at System.Net.TlsStream.EndWrite(IAsyncResult asyncResult)\r\n   at System.Net.ConnectStream.WriteHeadersCallback(IAsyncResult ar)",
      "RemoteStackTraceString": null,
      "RemoteStackIndex": 0,
      "Source": "System",
      "WatsonBuckets": null
    },
    "HelpURL": null,
    "StackTraceString": "   at System.Net.HttpWebRequest.EndGetResponse(IAsyncResult asyncResult)\r\n   at System.Net.Http.HttpClientHandler.GetResponseCallback(IAsyncResult ar)",
    "RemoteStackTraceString": null,
    "RemoteStackIndex": 0,
    "ExceptionMethod": "8\nEndGetResponse\nSystem, Version=4.0.0.0, Culture=neutral, PublicKeyToken",
    "HResult": -2146233079,
    "Source": "System",
    "WatsonBuckets": null
  },
  "HelpURL": null
}

故障排查方法与解决方案 #

• 检查本地服务状态：确认Self-hosted Integration Runtime Host Service是否正在运行。打开服务管理器，找到对应服务，若未启动则手动启动，设置为自动启动避免后续问题。
• 验证网络连通性：
  • 测试本地机器到ADF服务端点（xxxdatafactory.eastus.datafactory.azure.net）的网络连通性，使用ping或telnet命令检查443端口是否可访问。
  • 检查本地防火墙、企业级防火墙或代理服务器是否阻止了到ADF服务的出站连接，确保允许443端口的HTTPS流量通过。
• SSL证书验证：
  • 确认本地机器信任ADF服务的SSL证书。通过浏览器访问ADF服务端点，查看证书是否有效且未过期，若证书不受信任，手动导入根证书到本地证书存储。
  • 检查Self-hosted Integration Runtime配置中指定的SSL证书是否有效，无过期、私钥匹配问题。
• 代理配置检查：如果本地机器通过代理访问互联网，确保Self-hosted Integration Runtime的代理配置正确，包括代理地址、端口、认证信息（若需要）。
• 检查ADF资源状态：确认Azure Data Factory实例处于正常运行状态，无资源限制或故障。
• 重启与重装：尝试重启Self-hosted Integration Runtime服务，若问题依旧，卸载后重新下载最新版本的Self-hosted Integration Runtime进行安装注册。

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