使用C# WebClient下载时出现SSL/TLS安全通道错误求助

问题背景 #

基于.NET 4.7.2开发的C#控制台应用，在尝试下载指定文件时，报错“请求已中止: 无法创建SSL/TLS安全通道”。尝试调整安全协议等常见方案后，问题仍未解决。

解决方案 #

• 调整安全协议配置：.NET 4.7+支持自动协商TLS版本，若手动指定需覆盖主流安全协议（TLS 1.2 + TLS 1.3），避免仅指定单一协议导致服务器端协议匹配失败；更推荐使用SystemDefault让系统自动选择最优协议。
• 修复请求头拼写错误：原代码中Accept头存在拼写错误（ext/html应为text/html），服务器无法识别该请求类型，可能触发拦截或错误响应。
• 提前配置安全协议：将ServicePointManager的配置移到WebClient实例化之前，确保配置在请求发起前生效，避免实例化后配置未同步的问题。
• 移除不必要的默认凭据：目标网站无需Windows身份验证，UseDefaultCredentials = true会发送无效凭据，干扰SSL握手过程。

修改后的完整代码 #

static void Main(string[] args)
{
    // 提前配置安全协议，确保在WebClient实例化前生效
    ServicePointManager.Expect100Continue = true;
    // 推荐使用SystemDefault让系统自动协商最优TLS版本（.NET 4.7+）
    ServicePointManager.SecurityProtocol = SecurityProtocolType.SystemDefault;
    // 若需手动指定，可覆盖主流协议
    // ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls13;

    WebClient_DownLoad(new Uri("https://www.cftc.gov/files/dea/history/com_disagg_txt_2024.zip"), "com_disagg_txt_2024.zip");
    Console.ReadLine();
}

public static void WebClient_DownLoad(Uri URI, string FileName)
{
    using (WebClient webclient = new WebClient())
    {
        webclient.CachePolicy = new System.Net.Cache.RequestCachePolicy(System.Net.Cache.RequestCacheLevel.BypassCache);
        
        // 修复Accept头的拼写错误
        webclient.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/5.0 (Windows NT 10; Win64; x64; rv:56.0) Gecko/20100101 Firefox/56.0");
        webclient.Headers.Add(HttpRequestHeader.Accept, "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
        webclient.Headers.Add(HttpRequestHeader.AcceptLanguage, "en-US,en;q=0.8");
        webclient.Headers.Add(HttpRequestHeader.AcceptEncoding, "gzip, deflate;q=0.8");
        webclient.Headers.Add(HttpRequestHeader.CacheControl, "no-cache");
        webclient.Headers.Add(HttpRequestHeader.KeepAlive, "keep-alive");
        
        // 移除不必要的默认凭据
        // webclient.UseDefaultCredentials = true;

        webclient.DownloadFileCompleted += WebClient_DownloadComplete;
        webclient.DownloadProgressChanged += WebClient_DownloadProgress;

        webclient.DownloadFileAsync(URI, FileName);
    };
}

private static void WebClient_DownloadProgress(object sender, DownloadProgressChangedEventArgs e)
{
    string Result = string.Format("已接收: {0}  总大小: {1}  进度: {2}%",
                         e.BytesReceived, e.TotalBytesToReceive, e.ProgressPercentage);
    Console.WriteLine(Result);
}

private static void WebClient_DownloadComplete(object sender, AsyncCompletedEventArgs e)
{
    if (!e.Cancelled)
    {
        if (e.Error != null)
            Console.WriteLine("错误: " + e.Error.Message);
        else
            Console.WriteLine("下载完成");
    }
    else
    {
        Console.WriteLine("下载已取消");
    }
}

额外说明 #

对于.NET 4.7及以上版本，SecurityProtocolType.SystemDefault是最优选择，它会继承操作系统的TLS配置，自动适配服务器端支持的最新安全协议，无需手动维护协议版本列表，能有效避免因协议不匹配导致的SSL连接失败。

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