.NET Exception: Received an unexpected EOF or 0 bytes from the transport stream.解决方法

.NET 2025年04月16日12:30

在 .NET 应用中试用HttpClient调用API异常报错“Received an unexpected EOF or 0 bytes from the transport stream，通常表示在进行 HTTPS 通信时，SSL/TLS 握手未能成功完成，导致连接被意外关闭。以下是一些常见原因及相应的解决方案：

常见报错原因与解决方案

1. TLS 协议版本不匹配

如果客户端和服务器支持的 TLS 协议版本不一致，可能会导致连接失败。确保双方使用兼容的 TLS 版本。

解决方案：

在客户端代码中显式指定使用的 TLS 版本，例如：

var handler = new HttpClientHandler
{
    SslProtocols = SslProtocols.Tls12
};
var httpClient = new HttpClient(handler);

请根据服务器支持的协议版本选择合适的 SslProtocols 值。

2. SSL 证书问题

无效或自签名的 SSL 证书可能会导致连接中断。确保服务器使用有效的证书，并且客户端信任该证书。

解决方案：

如果在开发或测试环境中使用自签名证书，可在客户端代码中添加证书验证回调以忽略证书错误（仅用于测试环境）：

var handler = new HttpClientHandler
{
    ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
};
var httpClient = new HttpClient(handler);

需要注意的是，忽略证书验证存在安全风险，尽量不要在生产环境中这么操作。

3. 服务器响应异常

服务器可能由于配置错误或其他原因，在未完成 TLS 握手的情况下关闭连接。检查服务器日志，确认是否存在相关错误信息。

解决方案：

确保服务器正确配置了 SSL/TLS，并且能够成功完成握手过程。如果服务器使用了反向代理或负载均衡器，确保这些组件也正确配置了 SSL/TLS。

4. 客户端与服务器地址配置问题

在某些情况下，客户端和服务器的地址配置顺序可能影响连接的建立。例如，在 ASP.NET Core 项目中，launchSettings.json 文件中的 applicationUrl 配置顺序可能导致此问题。

解决方案：

尝试调整 applicationUrl 中的地址顺序，例如将 http 放在 https 之前：

"applicationUrl": "http://localhost:5000;https://localhost:5001"

这种调整可能有助于解决连接问题。

其他建议

更新 .NET SDK 和运行时：确保使用的 .NET SDK 和运行时是最新版本，以获得最新的安全和功能更新。使用网络抓包工具：使用工具（如 Wireshark）分析客户端和服务器之间的通信，查看 TLS 握手过程是否正常。检查防火墙和代理设置：确保防火墙或代理服务器未拦截或修改 TLS 流量。检查网络配置：重置网络连接配置，然后重启电脑或服务器重试。检查是否试用VPN：如果试用了VPN，尝试断开后再发起请求，看看是否仍然存在问题。关闭IPV6：如果试用了IPV6尝试关闭IPV6，试用IPV4再发起请求。