使用HttpClient下载GitHub Releases文件时超时问题求助

核心原因 #

GitHub Releases提供的exe安装包体积通常较大（比如示例中的PowerToys安装包约150MB），你当前使用的GetAsync默认采用HttpCompletionOption.ResponseContentRead模式——该模式会等待整个响应内容全部下载完成后才返回结果，配合HttpClient默认的10秒超时设置，大文件的下载耗时很容易超过阈值，从而触发超时异常。而浏览器采用流式处理响应，无需等待完整文件下载即可逐步写入本地，因此能正常完成下载。

修复代码 #

将GetAsync调用改为使用HttpCompletionOption.ResponseHeadersRead模式，客户端在收到响应头后就立即返回，后续读取流的过程不再受HttpClient的全局超时限制（若需控制下载过程的超时，可单独为流读取操作设置超时）：

// 收到响应头就返回，不等待完整内容下载
HttpResponseMessage message = await _httpClient.GetAsync(
    sourceUri, 
    HttpCompletionOption.ResponseHeadersRead, 
    cancellationToken);
message.EnsureSuccessStatusCode();
return await message.Content.ReadAsStreamAsync();

额外建议 #

• 若需更精细的超时控制，可在读取流时通过CancellationTokenSource单独设置操作超时，避免长时间无响应
• 保留浏览器标识的UserAgent配置，降低被GitHub CDN拦截的概率：

  _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
  

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