WebClient DownloadFileAsync()工作异常：下载文件与原文件不一致排查

嘿，我来帮你排查下WebClient下载文件后大小不对、内容不一致的问题！这种情况我碰到过好多次，大概率是下面几个常见原因，结合你可能的代码场景来分析：

1. 误用文本类方法处理二进制文件 #

如果你的代码用了DownloadString()，或者把下载内容当成字符串处理后再写入文件，那绝对会出问题！像图片、压缩包、exe这类二进制文件根本不能用字符串操作——字符串会按指定编码（比如UTF-8）解析字节，直接导致部分字节丢失或转码错误，文件自然和原文件不一样。

• 正确做法：用专门的二进制下载方法：

  // 方法1：直接下载到文件，最简单可靠
  using (var client = new WebClient())
  {
      client.DownloadFile("你的服务器文件URL", "本地保存路径");
  }
  
  // 方法2：获取字节数组后写入文件
  using (var client = new WebClient())
  {
      byte[] fileBytes = client.DownloadData("你的服务器文件URL");
      File.WriteAllBytes("本地保存路径", fileBytes);
  }
  

2. 流未正确释放/未读完所有内容 #

要是你手动用OpenRead()获取流来读写文件，却没处理好流的关闭，或者没确保把流里的内容全部读完，就会出现只写入部分内容的情况，文件大小自然偏小。

• 正确做法：用using语句自动管理流的生命周期，确保内容全部写入：

  using (var client = new WebClient())
  using (var remoteStream = client.OpenRead("你的服务器文件URL"))
  using (var localStream = new FileStream("本地保存路径", FileMode.Create))
  {
      // 推荐用CopyTo自动完成全部内容的复制
      remoteStream.CopyTo(localStream);
  
      // 要是手动读字节，一定要循环到读完为止
      // byte[] buffer = new byte[4096];
      // int bytesRead;
      // while ((bytesRead = remoteStream.Read(buffer, 0, buffer.Length)) > 0)
      // {
      //     localStream.Write(buffer, 0, bytesRead);
      // }
  }
  

3. 服务器返回压缩内容，WebClient未自动解压 #

不少服务器会默认返回gzip/deflate压缩后的内容，如果WebClient没开启自动解压，你下载的就是压缩后的字节，文件大小肯定比原文件小很多。

• 解决办法：开启自动解压（.NET Framework需要继承WebClient重写方法，.NET Core/5+支持更简便的设置）：

  // 针对.NET Framework，自定义支持解压的WebClient
  public class GzipEnabledWebClient : WebClient
  {
      protected override WebRequest GetWebRequest(Uri address)
      {
          var request = (HttpWebRequest)base.GetWebRequest(address);
          request.AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate;
          return request;
      }
  }
  
  // 使用自定义的WebClient下载
  using (var client = new GzipEnabledWebClient())
  {
      client.DownloadFile("你的服务器文件URL", "本地保存路径");
  }
  

4. 下载中途中断未检测 #

网络波动、服务器临时断开都可能导致下载中途停止，这时候本地文件只有部分内容，大小自然不对。你可以在下载后对比本地文件和服务器文件的大小，验证完整性：

using (var client = new WebClient())
{
    // 获取服务器文件的大小
    client.OpenRead("你的服务器文件URL");
    if (long.TryParse(client.ResponseHeaders[HttpResponseHeader.ContentLength], out long serverSize))
    {
        var localFile = new FileInfo("本地保存路径");
        if (localFile.Length != serverSize)
        {
            Console.WriteLine("文件下载不完整！请重新下载");
        }
    }
}

5. 错误设置编码（仅针对文本文件） #

如果是文本文件，错误的编码设置可能导致文件大小变化，但二进制文件绝对不要设置编码！比如不要用Encoding.UTF8去处理二进制字节，这会直接破坏文件内容。

虽然看不到你发的截图，但如果下载后的文件大小明显偏小或者打开是乱码，大概率是前两个原因中的一个——用了文本方法下载二进制文件，或者流没处理好。

要是对照后还是找不到问题，把你的代码贴出来，我再帮你精准定位！

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