C++调用curl下载文件报错Recv failure: Connection was reset求助

Recv failure: Connection was reset属于TCP传输阶段的错误，指连接对端主动发送RST包断开了连接，结合你开发环境正常、客户端环境异常的情况，按以下优先级排查：

网络层校验 #

• 首先在故障客户端的命令行直接执行curl [你的下载地址] -v，确认原生curl是否能正常拉取资源：
  • 若原生curl同样报错，首先排查客户端网络限制：包括本地防火墙、企业内网代理、安全管控软件是否拦截了对应域名/IP的HTTP请求
  • 若原生curl可正常下载，说明问题出在你的C++代码的curl配置差异

代码配置排查 #

• 检查代理配置：确认代码中是否硬编码了开发环境的代理参数，未适配客户端的网络环境，可通过curl_easy_setopt(curl, CURLOPT_PROXY, NULL)显式关闭强制代理，适配自动识别场景
• 调整超时参数：开发环境网络延迟低，不合理的超时配置不会触发，客户端高延迟场景下容易被服务端主动断连，建议添加如下配置：

  // 允许低速率传输，10秒内平均速率低于100字节/s才断开
  curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 100L);
  curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 10L);
  // 总超时根据文件大小合理设置，此处示例为300秒
  curl_easy_setopt(curl, CURLOPT_TIMEOUT, 300L);
  

• 补全请求头：部分服务端的WAF策略会拦截缺失合法User-Agent的请求，建议显式设置UA：

  curl_easy_setopt(curl, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36");
  

• 开启跳转跟随：如果服务端配置了HTTP跳HTTPS，未开启跳转跟随的情况下部分服务端会直接重置连接，添加配置：

  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_MAXREDIRS, 5L);
  

服务端校验 #

• 查看服务端访问日志，确认故障客户端的请求是否到达服务端：
  • 无请求日志：故障出在客户端到服务端的中间网络链路，需排查运营商、CDN、防火墙的拦截策略
  • 有请求日志且返回异常状态码：根据状态码调整请求逻辑或服务端配置，比如403对应权限校验失败、429对应请求频率超限被临时拦截

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