URLDownloadToFile无法从浏览器下载zip文件 执行挂起问题咨询

问题根因梳理 #

• 本地文件路径未做转义处理，C/C++字符串中反斜杠为转义字符，单写反斜杠会导致路径解析错误
• 目标URL存在连续多余斜杠，部分服务端无法正常解析此类请求，会导致请求长时间挂起无返回
• URLDownloadToFile为同步接口，默认未设置网络超时，网络波动、服务端无响应时会永久阻塞
• 接口直接在UI主线程调用时，会阻塞消息循环，表现为程序无响应
• 高版本Windows系统的IE安全区域限制，未授信的站点请求会被拦截或挂起

修复方案 #

1. 修正路径与URL格式 #

修正后的基础代码如下：

// 本地路径双写反斜杠转义，补全语句末尾分号
CString sZipFile = _T("d:\\myFolder\\abc-candidate\\candidate.zip");
// 清理URL中多余的连续斜杠
CString sSource = _T("http://test.abc.com/cs/Ds/Es/F/GHI/candidate/file1"); 

HRESULT res = URLDownloadToFile(NULL, sSource, sZipFile, 0, NULL);
if (res == S_OK) {
    printf("Ok\n");
}

2. 增加网络超时配置 #

调用UrlMkSetSessionOption提前设置各阶段网络超时，避免永久阻塞：

#include <urlmon.h>
#pragma comment(lib, "urlmon.lib")

// 设置30秒超时，单位为毫秒
DWORD dwTimeout = 30 * 1000;
UrlMkSetSessionOption(URLMON_OPTION_CONNECTTIMEOUT, &dwTimeout, sizeof(dwTimeout), 0);
UrlMkSetSessionOption(URLMON_OPTION_SENDTIMEOUT, &dwTimeout, sizeof(dwTimeout), 0);
UrlMkSetSessionOption(URLMON_OPTION_RECEIVETIMEOUT, &dwTimeout, sizeof(dwTimeout), 0);

// 再执行下载逻辑
HRESULT res = URLDownloadToFile(NULL, sSource, sZipFile, 0, NULL);

注意：UrlMkSetSessionOption设置的超时规则对当前进程内所有urlmon相关接口全局生效

3. 补充完整错误判断 #

不要仅判断S_OK，通过错误码可快速定位问题：

HRESULT res = URLDownloadToFile(NULL, sSource, sZipFile, 0, NULL);
switch(res) {
    case S_OK: 
        printf("下载成功\n"); 
        break;
    case E_OUTOFMEMORY: 
        printf("内存不足，分配失败\n"); 
        break;
    case INET_E_DOWNLOAD_FAILURE: 
        printf("资源访问失败，请检查URL有效性、网络连通性\n"); 
        break;
    default: 
        printf("下载失败，错误码：0x%X\n", res);
}

4. 优化执行逻辑 #

将下载逻辑放到子线程中执行，避免阻塞UI主线程的消息循环；如果请求站点为自有服务，可将站点加入系统IE的信任站点列表，避免安全策略拦截。

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