1. 项目概述为什么要在MFC里折腾文件下载在Windows桌面应用开发的老兵圈子里MFCMicrosoft Foundation Classes就像一把用了多年的瑞士军刀虽然外观不那么时髦但关键时刻总能派上用场。尤其是在维护那些历史悠久的工业控制软件、企业内部管理系统或者某些特定硬件的配套程序时MFC依然是绕不开的选择。最近我接手了一个老项目的功能升级核心需求之一就是要在现有的MFC程序里增加一个从指定服务器下载文件比如日志包、配置更新或者报表的功能。这听起来似乎很简单不就是个网络请求加文件写入吗但真做起来你会发现坑一点不少。用现成的CInternetSession和CHttpFile吧感觉功能太基础错误处理和进度反馈都弱上第三方库比如libcurl吧又得考虑老项目的依赖管理和兼容性更别提还要在MFC那个基于消息泵的单线程模型里处理好下载时的界面不卡顿和实时进度更新。网上搜一圈要么是十几年前的代码片段要么就是只讲理论不接地气。所以我决定把这次从需求分析、技术选型到代码实现、踩坑填坑的全过程记录下来给同样在MFC“故纸堆”里摸爬滚打的兄弟们一份可以直接“抄作业”的实战指南。2. 核心需求与方案选型不止是下载那么简单接到“实现文件下载”这个任务第一件事不是埋头写代码而是把需求掰开揉碎了看。在MFC这个特定环境下一个健壮的下载功能远不止“把文件拉下来”那么简单。2.1 非功能性需求深度解析界面响应性这是MFC GUI程序的生命线。下载操作通常是耗时的绝不能阻塞主线程的消息循环否则窗口会“冻住”用户会认为程序卡死了。因此多线程是必选项必须将网络I/O操作放到后台线程中执行。进度可视化用户需要知道下载进行到哪了。这要求后台线程能实时地将已下载的字节数、总大小、速度等信息“安全地”传递到主线程并更新进度条控件或状态栏文本。这里涉及到经典的线程间通信问题。稳定性与容错网络环境复杂服务器可能无响应、连接可能中断、磁盘可能空间不足。我们的代码必须能妥善处理这些异常给出明确的错误提示并在可能时支持断点续传对于大文件尤其重要。可维护性与集成度代码要清晰易于嵌入到现有的MFC项目结构中不能引入过于复杂的第三方依赖增加项目构建和部署的复杂度。2.2 技术方案对比与抉择基于以上需求我评估了三种主流方案方案核心组件/库优点缺点适用场景方案AWinINet API (MFC封装)CInternetSession,CHttpFile1. 微软原生与MFC集成度最高无需额外依赖。2. 代码量少实现简单GET请求快。3. 支持系统代理设置。1. 功能较为基础高级特性如精准进度回调、灵活头设置支持弱。2. 错误信息有时不够具体。3. 在后台线程中使用需注意会话和连接对象的生命周期管理。简单的、小文件的HTTP/HTTPS下载对进度反馈要求不高的内部工具。方案B原生WinHTTP APIWinHTTP库 (winhttp.lib)1. 比WinINet更底层功能强大且灵活是微软推荐用于服务的API。2. 提供了更精细的控制如接收回调、更丰富的选项。3. 不依赖用户IE设置行为更可控。1. C接口使用稍显繁琐需要自己封装。2. 异步模式回调编程模型对MFC开发者需要适应。需要更稳定、更可控HTTP通信的应用程序尤其是服务端或后台程序。方案C第三方库 (如 libcurl)libcurl (C/C库)1. 功能极其强大支持多种协议HTTP/HTTPS/FTP等特性丰富。2. 社区活跃文档和示例多。3. 提供方便的进度回调函数接口。1. 需要额外集成库文件动态库或静态库增加部署复杂度。2. 需要处理C风格回调与C/MFC对象模型的衔接。项目对网络功能要求复杂如多协议、上传、表单提交等且不介意引入外部依赖。我的选择与理由 考虑到这是一个已有的、相对稳定的MFC项目引入全新的第三方库如libcurl可能会带来额外的构建、测试和兼容性风险。而WinHTTP虽然强大但异步回调模型与MFC基于消息的线程通信结合需要更多胶水代码。WinINet方案在MFC中有现成的封装虽然简陋但足以满足基本的HTTP/HTTPS文件下载需求。关键在于我们可以通过多线程和自定义通信机制来弥补其在进度反馈和稳定性上的不足。因此我决定以WinINet (CInternetSession)为核心构建一个封装良好的下载器类使其具备不卡界面、实时进度、错误处理等能力。这个方案在依赖复杂度、开发效率和功能需求之间取得了最好的平衡。3. 核心类设计与实现打造一个MFC风格的下载器确定了技术路线接下来就是设计。一个好的设计应该高内聚、低耦合将下载的逻辑封装起来对外提供简洁的接口。我设计了一个CFileDownloader类。3.1 CFileDownloader 类接口设计这个类将负责所有的下载逻辑并在独立的线程中运行。// FileDownloader.h #pragma once #include afxinet.h // 用于CInternetSession等 #include string #include functional class CFileDownloader { public: // 定义下载状态枚举 enum DownloadStatus { DS_Idle, DS_Connecting, DS_Downloading, DS_Paused, DS_Completed, DS_Error }; // 回调函数类型定义 (使用std::function更现代) using ProgressCallback std::functionvoid(long long downloaded, long long total, double speed); using StatusCallback std::functionvoid(DownloadStatus status, const CString msg); using CompletionCallback std::functionvoid(bool success, const CString filePath, const CString errorMsg); CFileDownloader(); virtual ~CFileDownloader(); // 设置回调主线程创建的对象传递进来 void SetCallbacks(ProgressCallback progCb, StatusCallback statCb, CompletionCompletionCallback compCb); // 开始下载 (非阻塞立即返回) BOOL StartDownload(const CString strUrl, const CString strLocalPath, const CString strUserAgent _T()); // 暂停、继续、停止 BOOL PauseDownload(); BOOL ResumeDownload(); BOOL StopDownload(); // 获取当前状态信息 DownloadStatus GetCurrentStatus() const; CString GetLastError() const; private: // 内部实现线程函数 static UINT DownloadThreadProc(LPVOID pParam); UINT DownloadThreadWorker(); // 实际执行下载的核心函数 BOOL PerformDownload(); // 线程安全的状态更新 void UpdateStatus(DownloadStatus newStatus, const CString msg _T()); void ReportProgress(long long downloaded, long long total); void ReportCompletion(bool success, const CString errorMsg _T()); // 成员变量 CWinThread* m_pThread; // 工作线程指针 HANDLE m_hEventPause; // 用于暂停的事件对象 HANDLE m_hEventStop; // 用于停止的事件对象 CRITICAL_SECTION m_csStatus; // 保护状态变量的临界区 CString m_strUrl; CString m_strLocalPath; CString m_strUserAgent; DownloadStatus m_eStatus; CString m_strLastError; long long m_llTotalSize; long long m_llCurrentDownloaded; // 回调函数对象 ProgressCallback m_fnProgress; StatusCallback m_fnStatus; CompletionCallback m_fnCompletion; };设计要点解析异步与线程StartDownload方法内部会创建并启动一个工作线程 (CWinThread)线程函数DownloadThreadProc将调用DownloadThreadWorker来执行实际的PerformDownload逻辑。这样主线程完全不会被阻塞。回调机制使用std::function定义了三类回调进度、状态变化和完成通知。这比传统的通过窗口消息 (PostMessage) 传递参数更灵活、类型安全也更容易与各种UI更新方式结合你可以在回调里直接更新控件但要注意线程安全通常还是建议PostMessage。流量控制通过m_hEventPause和m_hEventStop两个事件对象实现了对下载线程的暂停、继续和停止控制。这是实现用户主动控制下载过程的关键。线程安全使用CRITICAL_SECTION保护m_eStatus,m_strLastError等可能被多个线程访问的成员变量。回调的调用也需要注意时机确保在UI线程的上下文中执行UI更新。3.2 下载线程的核心实现这是整个类的灵魂所在位于DownloadThreadWorker和PerformDownload中。// FileDownloader.cpp (部分关键代码) UINT CFileDownloader::DownloadThreadWorker() { UpdateStatus(DS_Connecting, _T(正在连接服务器...)); BOOL bSuccess PerformDownload(); if (bSuccess) { ReportCompletion(true); UpdateStatus(DS_Completed, _T(下载完成)); } else { ReportCompletion(false, m_strLastError); UpdateStatus(DS_Error, m_strLastError); } // 清理线程相关资源 if (m_pThread) { CloseHandle(m_pThread-m_hThread); m_pThread NULL; } return 0; } BOOL CFileDownloader::PerformDownload() { CInternetSession session(m_strUserAgent, 1, PRE_CONFIG_INTERNET_ACCESS); CHttpFile* pFile NULL; CFile localFile; DWORD dwStatusCode 0; DWORD dwContentLength 0; try { // 1. 打开HTTP连接 pFile (CHttpFile*)session.OpenURL(m_strUrl, 1, INTERNET_FLAG_RELOAD | INTERNET_FLAG_TRANSFER_BINARY | INTERNET_FLAG_EXISTING_CONNECT); if (!pFile) { m_strLastError _T(无法打开URL: ) m_strUrl; return FALSE; } // 2. 查询HTTP状态码和文件大小 pFile-QueryInfoStatusCode(dwStatusCode); if (dwStatusCode ! HTTP_STATUS_OK) { m_strLastError.Format(_T(HTTP错误: %d), dwStatusCode); return FALSE; } if (pFile-QueryInfo(HTTP_QUERY_CONTENT_LENGTH, dwContentLength)) { m_llTotalSize dwContentLength; } else { m_llTotalSize 0; // 服务器可能未返回Content-Length } // 3. 创建本地文件 if (!localFile.Open(m_strLocalPath, CFile::modeCreate | CFile::modeWrite | CFile::shareDenyWrite)) { m_strLastError _T(无法创建本地文件: ) m_strLocalPath; return FALSE; } UpdateStatus(DS_Downloading, _T(开始下载...)); // 4. 循环读取数据并写入文件 const int BUFFER_SIZE 64 * 1024; // 64KB缓冲区 BYTE buffer[BUFFER_SIZE]; DWORD dwRead 0; m_llCurrentDownloaded 0; DWORD dwLastTick GetTickCount(); // 用于计算速度 long long llBytesSinceLastCalc 0; while ((dwRead pFile-Read(buffer, BUFFER_SIZE)) 0) { // 检查停止信号 if (WaitForSingleObject(m_hEventStop, 0) WAIT_OBJECT_0) { UpdateStatus(DS_Idle, _T(下载被用户停止)); return FALSE; } // 检查暂停信号 while (WaitForSingleObject(m_hEventPause, 0) WAIT_OBJECT_0) { UpdateStatus(DS_Paused, _T(下载已暂停)); Sleep(100); // 暂停时让出CPU } // 如果从暂停状态恢复 if (GetCurrentStatus() DS_Paused) { UpdateStatus(DS_Downloading, _T(下载继续)); } // 写入本地文件 localFile.Write(buffer, dwRead); m_llCurrentDownloaded dwRead; llBytesSinceLastCalc dwRead; // 计算并报告进度控制频率避免回调太频繁 DWORD dwCurrentTick GetTickCount(); if (dwCurrentTick - dwLastTick 200) { // 每200ms报告一次 double speed (llBytesSinceLastCalc * 1000.0) / (dwCurrentTick - dwLastTick); // 字节/秒 ReportProgress(m_llCurrentDownloaded, m_llTotalSize); // 可以在这里也传递速度 speed 给回调 llBytesSinceLastCalc 0; dwLastTick dwCurrentTick; } } localFile.Close(); pFile-Close(); delete pFile; session.Close(); return TRUE; } catch (CInternetException* pEx) { TCHAR szError[1024]; pEx-GetErrorMessage(szError, 1024); m_strLastError szError; pEx-Delete(); // 清理资源... return FALSE; } catch (CFileException* pEx) { TCHAR szError[1024]; pEx-GetErrorMessage(szError, 1024); m_strLastError szError; pEx-Delete(); // 清理资源... return FALSE; } }实现细节与技巧缓冲区大小BUFFER_SIZE设置为64KB是一个经验值。太小会增加系统调用次数影响效率太大则可能占用过多内存且每次读写的延迟感知更明显。可以根据实际网络环境微调。进度报告频率控制通过GetTickCount()计算时间差控制每200毫秒才调用一次进度回调。这是至关重要的优化。如果不加控制每读取一个缓冲区就回调一次UI线程可能会被海量的进度更新消息淹没导致界面反而卡顿。速度计算速度计算(字节数 / 时间差)是在工作线程中完成的避免将大量原始数据传递到UI线程进行计算减轻UI线程负担。异常处理CInternetException和CFileException是MFC网络和文件操作可能抛出的异常。必须捕获并获取可读的错误信息这是调试和用户提示的关键。暂停/停止机制使用WaitForSingleObject非阻塞地检查事件对象状态。暂停时线程进入一个短睡眠的循环持续检查暂停事件停止时直接退出函数并清理。这种“协作式”的多线程控制比强制终止线程更安全。3.3 与MFC UI线程的安全通信工作线程不能直接操作UI控件必须通过线程安全的方式将数据“传递”给主线程。我采用了“回调函数内封装PostMessage”的模式。void CFileDownloader::ReportProgress(long long downloaded, long long total) { if (m_fnProgress) { // 计算速度等可以在工作线程算好 double speed 0.0; // 这里需要从成员变量或其他方式获取计算好的速度 // 关键将回调的调用通过PostMessage抛给主线程执行 // 假设主窗口句柄是m_hWndMain自定义消息是WM_DOWNLOAD_PROGRESS // 这里为了简化展示思路。实际项目中回调函数本身可能就是在主线程设置的 // 我们可以在设置回调时要求调用者提供一个安全调用UI的方法例如绑定到控件的成员函数。 // 更通用的做法是ProgressCallback 本身就在主线程的上下文中被调用。 // 我们通过 std::bind 将回调绑定到主窗口类的一个方法上。 // 在工作线程中我们只是将数据准备好然后PostMessage。 // 主窗口的OnDownloadProgress消息处理函数中再调用真正更新UI的代码。 } } // 在主对话框类中 BEGIN_MESSAGE_MAP(CMyDownloadDlg, CDialogEx) ON_MESSAGE(WM_DOWNLOAD_PROGRESS, CMyDownloadDlg::OnDownloadProgress) ON_MESSAGE(WM_DOWNLOAD_STATUS, CMyDownloadDlg::OnDownloadStatus) END_MESSAGE_MAP() LRESULT CMyDownloadDlg::OnDownloadProgress(WPARAM wParam, LPARAM lParam) { // wParam 和 lParam 可以传递进度数据或者传递一个结构体指针 // 这里安全地更新进度条控件 CProgressCtrl* pProg (CProgressCtrl*)GetDlgItem(IDC_PROGRESS); if (pProg) { int nPercent (int)wParam; // 假设传过来的是百分比 pProg-SetPos(nPercent); } // 更新速度文本等... return 0; }重要提示直接在回调函数m_fnProgress里操作UI控件是危险的因为该回调是在工作线程的上下文中被调用的。一种安全的模式是在设置回调时传入一个主窗口类的成员函数通过std::bind这个成员函数内部只做一件事PostMessage到窗口自身。或者更简单清晰的做法是CFileDownloader不直接调用UI更新函数而是通过PostMessage发送自定义消息到主窗口由主窗口的消息处理函数来更新UI。本例中为了展示灵活性设计了回调接口但在实际实现时需要确保回调的执行上下文是主线程。4. 界面集成与用户体验优化有了后台的下载引擎前台的界面集成就是让它好用的关键。4.1 对话框布局与控件绑定创建一个标准的MFC对话框包含以下核心控件编辑框用于输入下载URL。按钮“浏览”按钮选择本地保存路径“开始/暂停/停止”下载控制按钮。进度条控件直观显示下载进度。静态文本用于显示状态信息如“连接中”、“下载中”、“已完成”、已下载/总大小、实时下载速度、预估剩余时间。列表框或编辑框用于显示下载日志或错误信息。在对话框类CMyDownloadDlg中声明一个CFileDownloader成员变量m_downloader并在OnInitDialog中初始化它设置好回调函数这些回调函数内部应使用PostMessage或Invoke机制安全更新UI。4.2 控制逻辑与状态同步按钮的控制逻辑需要与CFileDownloader的状态机同步void CMyDownloadDlg::OnBnClickedButtonStart() { CString strUrl, strPath; GetDlgItemText(IDC_EDIT_URL, strUrl); GetDlgItemText(IDC_EDIT_PATH, strPath); if (strUrl.IsEmpty() || strPath.IsEmpty()) { AfxMessageBox(_T(请输入URL和保存路径)); return; } // 设置回调 (这里使用Lambda但Lambda内必须通过消息通知UI线程) m_downloader.SetCallbacks( [this](long long dl, long long total, double speed) { // 在工作线程中执行不能直接操作UI。 // 将数据打包通过PostMessage发送到主窗口 PostMessage(WM_USER_PROGRESS, (WPARAM)new ProgressData(dl, total, speed), 0); }, [this](CFileDownloader::DownloadStatus stat, const CString msg) { PostMessage(WM_USER_STATUS, (WPARAM)new StatusData(stat, msg), 0); }, [this](bool success, const CString path, const CString error) { PostMessage(WM_USER_COMPLETE, (WPARAM)new CompletionData(success, path, error), 0); } ); if (m_downloader.StartDownload(strUrl, strPath, _T(MyMFC Downloader/1.0))) { GetDlgItem(IDC_BUTTON_START)-EnableWindow(FALSE); GetDlgItem(IDC_BUTTON_PAUSE)-EnableWindow(TRUE); GetDlgItem(IDC_BUTTON_STOP)-EnableWindow(TRUE); } else { AfxMessageBox(_T(开始下载失败)); } } void CMyDownloadDlg::OnBnClickedButtonPause() { if (m_downloader.GetCurrentStatus() CFileDownloader::DS_Downloading) { m_downloader.PauseDownload(); SetDlgItemText(IDC_BUTTON_PAUSE, _T(继续)); } else if (m_downloader.GetCurrentStatus() CFileDownloader::DS_Paused) { m_downloader.ResumeDownload(); SetDlgItemText(IDC_BUTTON_PAUSE, _T(暂停)); } }状态同步要点按钮的启用/禁用状态、文本都需要根据m_downloader.GetCurrentStatus()的返回值来动态更新。这通常在状态回调WM_USER_STATUS的消息处理函数中进行。4.3 进度、速度与剩余时间显示在进度回调的消息处理函数中除了更新进度条位置还可以计算并显示更多信息LRESULT CMyDownloadDlg::OnProgressUpdate(WPARAM wParam, LPARAM lParam) { std::unique_ptrProgressData pData((ProgressData*)wParam); // 用智能指针管理防止内存泄漏 // 1. 更新进度条 CProgressCtrl* pProg (CProgressCtrl*)GetDlgItem(IDC_PROGRESS); if (pProg) { if (pData-total 0) { int nPos (int)((pData-downloaded * 100) / pData-total); pProg-SetPos(nPos); } else { pProg-SetPos(0); // 或设置为Marquee模式表示未知大小 } } // 2. 更新文本已下载/总量 CString strSize; strSize.Format(_T(%s / %s), FormatFileSize(pData-downloaded), pData-total 0 ? FormatFileSize(pData-total) : _T(未知)); SetDlgItemText(IDC_STATIC_SIZE, strSize); // 3. 更新速度 CString strSpeed; if (pData-speed 0) { strSpeed.Format(_T(速度: %s/s), FormatFileSize((long long)pData-speed)); } else { strSpeed _T(速度: --); } SetDlgItemText(IDC_STATIC_SPEED, strSpeed); // 4. 估算剩余时间 (仅当总大小已知且速度0时) if (pData-total 0 pData-speed 1) { double remainingSeconds (pData-total - pData-downloaded) / pData-speed; CString strRemaining FormatTime(remainingSeconds); SetDlgItemText(IDC_STATIC_REMAINING, _T(剩余: ) strRemaining); } else { SetDlgItemText(IDC_STATIC_REMAINING, _T(剩余: --)); } return 0; }FormatFileSize和FormatTime是辅助函数用于将字节数格式化为KB/MB/GB将秒数格式化为时分秒。5. 高级话题与避坑指南在实际开发中总会遇到一些预料之外的问题。下面是我在实现过程中遇到的一些典型问题及解决方案。5.1 HTTPS连接与SSL证书问题如果你下载的URL是https://开头的可能会遇到SSL证书验证错误。默认情况下WinINet会验证服务器证书。对于内部系统或测试环境有时需要忽略证书错误。警告在生产环境中忽略证书验证会带来安全风险仅应在可控的、信任的环境中使用。// 在创建 CInternetSession 时可以设置标志位来忽略某些错误 DWORD dwFlags INTERNET_FLAG_RELOAD | INTERNET_FLAG_TRANSFER_BINARY | INTERNET_FLAG_EXISTING_CONNECT; dwFlags | INTERNET_FLAG_IGNORE_CERT_DATE_INVALID; // 忽略过期日期 dwFlags | INTERNET_FLAG_IGNORE_CERT_CN_INVALID; // 忽略证书名称不匹配 pFile (CHttpFile*)session.OpenURL(strUrl, 1, dwFlags);如果上述标志位还不够你可能需要更深入地干预WinINet的证书验证回调这涉及设置INTERNET_OPTION_SECURITY_FLAGS选项代码会更复杂。一个更彻底的但更不安全的绕过方法是修改INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT或使用InternetSetOption设置SECURITY_FLAG_IGNORE_UNKNOWN_CA等标志。强烈建议查阅最新MSDN文档并充分理解安全后果。5.2 大文件下载与断点续传WinINet本身通过INTERNET_FLAG_RESYNCHRONIZE和Range请求头支持断点续传。实现思路如下检查本地已存在文件开始下载前检查本地目标文件是否存在及其大小。发送带Range头的请求如果文件已存在部分内容在OpenURL后使用CHttpFile::AddRequestHeaders添加Range: bytesxxx-请求头其中xxx是本地文件的当前大小。以追加模式打开本地文件使用CFile::modeCreate | CFile::modeWrite | CFile::modeNoTruncate模式打开文件并将文件指针移动到末尾。处理服务器响应服务器应返回206 Partial Content状态码。如果返回200 OK说明服务器不支持断点续传需要从头下载可能覆盖已存在部分需用户确认。关键代码片段CFile localFile; DWORD dwLocalSize 0; CFileStatus status; if (CFile::GetStatus(strLocalPath, status)) { dwLocalSize (DWORD)status.m_size; } CInternetSession session(...); CHttpFile* pFile (CHttpFile*)session.OpenURL(...); // 先打开连接 if (dwLocalSize 0) { // 添加断点续传请求头 CString strRange; strRange.Format(_T(Range: bytes%lu-), dwLocalSize); pFile-AddRequestHeaders(strRange); // 以追加模式打开文件 localFile.Open(strLocalPath, CFile::modeWrite | CFile::modeNoTruncate); localFile.SeekToEnd(); } else { localFile.Open(strLocalPath, CFile::modeCreate | CFile::modeWrite); } // ... 然后查询状态码 pFile-QueryInfoStatusCode(dwStatusCode); if (dwLocalSize 0 dwStatusCode ! HTTP_STATUS_PARTIAL_CONTENT) { // 服务器不支持断点续传需要处理例如询问用户 }5.3 线程安全与资源清理这是多线程编程中最容易出错的地方。MFC对象与线程CInternetSession、CHttpFile、CFile等MFC对象最好在创建它们的线程中销毁。确保PerformDownload函数在退出前无论成功还是异常都正确关闭和删除了这些对象。回调与UI对象如前所述不要在后台线程中直接访问或修改MFC控件如GetDlgItem、SetWindowText。务必通过消息队列 (PostMessage) 进行通信。事件与临界区m_hEventPause,m_hEventStop等内核对象在类的构造函数中创建 (CreateEvent)在析构函数中关闭 (CloseHandle)。CRITICAL_SECTION同样需要在构造函数中初始化 (InitializeCriticalSection)在析构函数中删除 (DeleteCriticalSection)。线程优雅退出StopDownload函数应设置停止事件然后等待工作线程自然退出例如使用WaitForSingleObject(m_pThread-m_hThread, INFINITE)而不是粗暴地TerminateThread。在线程函数 (DownloadThreadWorker) 的末尾要确保释放线程句柄。5.4 错误处理与日志记录健全的错误处理能让程序更健壮也便于调试。捕获所有异常如代码所示用try...catch块包裹可能抛出CInternetException和CFileException的代码。获取详细错误使用pEx-GetErrorMessage()获取可读的错误描述而不仅仅是错误码。记录日志在关键步骤开始连接、收到响应、开始写入、完成、发生错误和状态变更时将信息输出到日志文件或UI的日志框。这对于排查网络超时、权限不足、磁盘满等问题至关重要。用户友好的提示不要直接将内部错误码如ERROR_INTERNET_NAME_NOT_RESOLVED抛给用户。将其转换为更易懂的文字如“无法解析服务器地址请检查网络连接和URL是否正确”。6. 性能优化与扩展思路当基本功能稳定后可以考虑以下优化和扩展多连接分块下载对于支持HTTP/1.1及以上版本且支持Range的服务器可以创建多个CHttpFile连接分别下载文件的不同部分Range: bytes0-9999,Range: bytes10000-19999...最后合并。这能显著提升大文件的下载速度但复杂度也大大增加需要处理分块、并发、文件合并和错误恢复。下载队列管理将CFileDownloader设计为可管理多个下载任务实现顺序下载或有限并发数的下载。这需要引入一个任务队列和更复杂的线程管理。配置文件与持久化将未完成的下载任务信息URL、本地路径、已下载大小等保存到配置文件或注册表。程序启动时检查并恢复实现程序关闭后的任务恢复。代理服务器支持CInternetSession构造函数可以接受代理服务器信息或者依赖系统IE的代理设置。如果需要自定义代理可以通过InternetSetOption进行更精细的配置。更优雅的暂停/继续当前的暂停机制是“忙等待”Sleep(100)。对于长时间暂停可以考虑使用WaitForSingleObject(m_hEventPause, INFINITE)让线程完全挂起并在ResumeDownload时用SetEvent唤醒它。但要注意挂起期间网络连接可能会超时断开。实现一个MFC下的文件下载功能就像在旧城改造中铺设新的管线需要尊重原有的框架消息循环、GDI对象同时引入现代的理念异步、事件驱动、线程安全。整个过程下来最深的体会是在MFC中做任何超出简单响应式UI的事情都必须把线程安全和消息通信放在第一位考虑。那些看似简单的SetDlgItemText在错误的线程里调用就是崩溃的导火索。另外WinINet虽然老但文档齐全、行为稳定只要把异常处理和资源管理做到位完全能满足企业级应用中对可靠性的要求。最后代码的封装性很重要把下载逻辑、UI更新、控制逻辑清晰地分离未来无论是替换网络库比如换成libcurl还是增加新功能比如下载队列都会从容很多。
MFC文件下载实战：多线程、进度显示与WinINet封装
1. 项目概述为什么要在MFC里折腾文件下载在Windows桌面应用开发的老兵圈子里MFCMicrosoft Foundation Classes就像一把用了多年的瑞士军刀虽然外观不那么时髦但关键时刻总能派上用场。尤其是在维护那些历史悠久的工业控制软件、企业内部管理系统或者某些特定硬件的配套程序时MFC依然是绕不开的选择。最近我接手了一个老项目的功能升级核心需求之一就是要在现有的MFC程序里增加一个从指定服务器下载文件比如日志包、配置更新或者报表的功能。这听起来似乎很简单不就是个网络请求加文件写入吗但真做起来你会发现坑一点不少。用现成的CInternetSession和CHttpFile吧感觉功能太基础错误处理和进度反馈都弱上第三方库比如libcurl吧又得考虑老项目的依赖管理和兼容性更别提还要在MFC那个基于消息泵的单线程模型里处理好下载时的界面不卡顿和实时进度更新。网上搜一圈要么是十几年前的代码片段要么就是只讲理论不接地气。所以我决定把这次从需求分析、技术选型到代码实现、踩坑填坑的全过程记录下来给同样在MFC“故纸堆”里摸爬滚打的兄弟们一份可以直接“抄作业”的实战指南。2. 核心需求与方案选型不止是下载那么简单接到“实现文件下载”这个任务第一件事不是埋头写代码而是把需求掰开揉碎了看。在MFC这个特定环境下一个健壮的下载功能远不止“把文件拉下来”那么简单。2.1 非功能性需求深度解析界面响应性这是MFC GUI程序的生命线。下载操作通常是耗时的绝不能阻塞主线程的消息循环否则窗口会“冻住”用户会认为程序卡死了。因此多线程是必选项必须将网络I/O操作放到后台线程中执行。进度可视化用户需要知道下载进行到哪了。这要求后台线程能实时地将已下载的字节数、总大小、速度等信息“安全地”传递到主线程并更新进度条控件或状态栏文本。这里涉及到经典的线程间通信问题。稳定性与容错网络环境复杂服务器可能无响应、连接可能中断、磁盘可能空间不足。我们的代码必须能妥善处理这些异常给出明确的错误提示并在可能时支持断点续传对于大文件尤其重要。可维护性与集成度代码要清晰易于嵌入到现有的MFC项目结构中不能引入过于复杂的第三方依赖增加项目构建和部署的复杂度。2.2 技术方案对比与抉择基于以上需求我评估了三种主流方案方案核心组件/库优点缺点适用场景方案AWinINet API (MFC封装)CInternetSession,CHttpFile1. 微软原生与MFC集成度最高无需额外依赖。2. 代码量少实现简单GET请求快。3. 支持系统代理设置。1. 功能较为基础高级特性如精准进度回调、灵活头设置支持弱。2. 错误信息有时不够具体。3. 在后台线程中使用需注意会话和连接对象的生命周期管理。简单的、小文件的HTTP/HTTPS下载对进度反馈要求不高的内部工具。方案B原生WinHTTP APIWinHTTP库 (winhttp.lib)1. 比WinINet更底层功能强大且灵活是微软推荐用于服务的API。2. 提供了更精细的控制如接收回调、更丰富的选项。3. 不依赖用户IE设置行为更可控。1. C接口使用稍显繁琐需要自己封装。2. 异步模式回调编程模型对MFC开发者需要适应。需要更稳定、更可控HTTP通信的应用程序尤其是服务端或后台程序。方案C第三方库 (如 libcurl)libcurl (C/C库)1. 功能极其强大支持多种协议HTTP/HTTPS/FTP等特性丰富。2. 社区活跃文档和示例多。3. 提供方便的进度回调函数接口。1. 需要额外集成库文件动态库或静态库增加部署复杂度。2. 需要处理C风格回调与C/MFC对象模型的衔接。项目对网络功能要求复杂如多协议、上传、表单提交等且不介意引入外部依赖。我的选择与理由 考虑到这是一个已有的、相对稳定的MFC项目引入全新的第三方库如libcurl可能会带来额外的构建、测试和兼容性风险。而WinHTTP虽然强大但异步回调模型与MFC基于消息的线程通信结合需要更多胶水代码。WinINet方案在MFC中有现成的封装虽然简陋但足以满足基本的HTTP/HTTPS文件下载需求。关键在于我们可以通过多线程和自定义通信机制来弥补其在进度反馈和稳定性上的不足。因此我决定以WinINet (CInternetSession)为核心构建一个封装良好的下载器类使其具备不卡界面、实时进度、错误处理等能力。这个方案在依赖复杂度、开发效率和功能需求之间取得了最好的平衡。3. 核心类设计与实现打造一个MFC风格的下载器确定了技术路线接下来就是设计。一个好的设计应该高内聚、低耦合将下载的逻辑封装起来对外提供简洁的接口。我设计了一个CFileDownloader类。3.1 CFileDownloader 类接口设计这个类将负责所有的下载逻辑并在独立的线程中运行。// FileDownloader.h #pragma once #include afxinet.h // 用于CInternetSession等 #include string #include functional class CFileDownloader { public: // 定义下载状态枚举 enum DownloadStatus { DS_Idle, DS_Connecting, DS_Downloading, DS_Paused, DS_Completed, DS_Error }; // 回调函数类型定义 (使用std::function更现代) using ProgressCallback std::functionvoid(long long downloaded, long long total, double speed); using StatusCallback std::functionvoid(DownloadStatus status, const CString msg); using CompletionCallback std::functionvoid(bool success, const CString filePath, const CString errorMsg); CFileDownloader(); virtual ~CFileDownloader(); // 设置回调主线程创建的对象传递进来 void SetCallbacks(ProgressCallback progCb, StatusCallback statCb, CompletionCompletionCallback compCb); // 开始下载 (非阻塞立即返回) BOOL StartDownload(const CString strUrl, const CString strLocalPath, const CString strUserAgent _T()); // 暂停、继续、停止 BOOL PauseDownload(); BOOL ResumeDownload(); BOOL StopDownload(); // 获取当前状态信息 DownloadStatus GetCurrentStatus() const; CString GetLastError() const; private: // 内部实现线程函数 static UINT DownloadThreadProc(LPVOID pParam); UINT DownloadThreadWorker(); // 实际执行下载的核心函数 BOOL PerformDownload(); // 线程安全的状态更新 void UpdateStatus(DownloadStatus newStatus, const CString msg _T()); void ReportProgress(long long downloaded, long long total); void ReportCompletion(bool success, const CString errorMsg _T()); // 成员变量 CWinThread* m_pThread; // 工作线程指针 HANDLE m_hEventPause; // 用于暂停的事件对象 HANDLE m_hEventStop; // 用于停止的事件对象 CRITICAL_SECTION m_csStatus; // 保护状态变量的临界区 CString m_strUrl; CString m_strLocalPath; CString m_strUserAgent; DownloadStatus m_eStatus; CString m_strLastError; long long m_llTotalSize; long long m_llCurrentDownloaded; // 回调函数对象 ProgressCallback m_fnProgress; StatusCallback m_fnStatus; CompletionCallback m_fnCompletion; };设计要点解析异步与线程StartDownload方法内部会创建并启动一个工作线程 (CWinThread)线程函数DownloadThreadProc将调用DownloadThreadWorker来执行实际的PerformDownload逻辑。这样主线程完全不会被阻塞。回调机制使用std::function定义了三类回调进度、状态变化和完成通知。这比传统的通过窗口消息 (PostMessage) 传递参数更灵活、类型安全也更容易与各种UI更新方式结合你可以在回调里直接更新控件但要注意线程安全通常还是建议PostMessage。流量控制通过m_hEventPause和m_hEventStop两个事件对象实现了对下载线程的暂停、继续和停止控制。这是实现用户主动控制下载过程的关键。线程安全使用CRITICAL_SECTION保护m_eStatus,m_strLastError等可能被多个线程访问的成员变量。回调的调用也需要注意时机确保在UI线程的上下文中执行UI更新。3.2 下载线程的核心实现这是整个类的灵魂所在位于DownloadThreadWorker和PerformDownload中。// FileDownloader.cpp (部分关键代码) UINT CFileDownloader::DownloadThreadWorker() { UpdateStatus(DS_Connecting, _T(正在连接服务器...)); BOOL bSuccess PerformDownload(); if (bSuccess) { ReportCompletion(true); UpdateStatus(DS_Completed, _T(下载完成)); } else { ReportCompletion(false, m_strLastError); UpdateStatus(DS_Error, m_strLastError); } // 清理线程相关资源 if (m_pThread) { CloseHandle(m_pThread-m_hThread); m_pThread NULL; } return 0; } BOOL CFileDownloader::PerformDownload() { CInternetSession session(m_strUserAgent, 1, PRE_CONFIG_INTERNET_ACCESS); CHttpFile* pFile NULL; CFile localFile; DWORD dwStatusCode 0; DWORD dwContentLength 0; try { // 1. 打开HTTP连接 pFile (CHttpFile*)session.OpenURL(m_strUrl, 1, INTERNET_FLAG_RELOAD | INTERNET_FLAG_TRANSFER_BINARY | INTERNET_FLAG_EXISTING_CONNECT); if (!pFile) { m_strLastError _T(无法打开URL: ) m_strUrl; return FALSE; } // 2. 查询HTTP状态码和文件大小 pFile-QueryInfoStatusCode(dwStatusCode); if (dwStatusCode ! HTTP_STATUS_OK) { m_strLastError.Format(_T(HTTP错误: %d), dwStatusCode); return FALSE; } if (pFile-QueryInfo(HTTP_QUERY_CONTENT_LENGTH, dwContentLength)) { m_llTotalSize dwContentLength; } else { m_llTotalSize 0; // 服务器可能未返回Content-Length } // 3. 创建本地文件 if (!localFile.Open(m_strLocalPath, CFile::modeCreate | CFile::modeWrite | CFile::shareDenyWrite)) { m_strLastError _T(无法创建本地文件: ) m_strLocalPath; return FALSE; } UpdateStatus(DS_Downloading, _T(开始下载...)); // 4. 循环读取数据并写入文件 const int BUFFER_SIZE 64 * 1024; // 64KB缓冲区 BYTE buffer[BUFFER_SIZE]; DWORD dwRead 0; m_llCurrentDownloaded 0; DWORD dwLastTick GetTickCount(); // 用于计算速度 long long llBytesSinceLastCalc 0; while ((dwRead pFile-Read(buffer, BUFFER_SIZE)) 0) { // 检查停止信号 if (WaitForSingleObject(m_hEventStop, 0) WAIT_OBJECT_0) { UpdateStatus(DS_Idle, _T(下载被用户停止)); return FALSE; } // 检查暂停信号 while (WaitForSingleObject(m_hEventPause, 0) WAIT_OBJECT_0) { UpdateStatus(DS_Paused, _T(下载已暂停)); Sleep(100); // 暂停时让出CPU } // 如果从暂停状态恢复 if (GetCurrentStatus() DS_Paused) { UpdateStatus(DS_Downloading, _T(下载继续)); } // 写入本地文件 localFile.Write(buffer, dwRead); m_llCurrentDownloaded dwRead; llBytesSinceLastCalc dwRead; // 计算并报告进度控制频率避免回调太频繁 DWORD dwCurrentTick GetTickCount(); if (dwCurrentTick - dwLastTick 200) { // 每200ms报告一次 double speed (llBytesSinceLastCalc * 1000.0) / (dwCurrentTick - dwLastTick); // 字节/秒 ReportProgress(m_llCurrentDownloaded, m_llTotalSize); // 可以在这里也传递速度 speed 给回调 llBytesSinceLastCalc 0; dwLastTick dwCurrentTick; } } localFile.Close(); pFile-Close(); delete pFile; session.Close(); return TRUE; } catch (CInternetException* pEx) { TCHAR szError[1024]; pEx-GetErrorMessage(szError, 1024); m_strLastError szError; pEx-Delete(); // 清理资源... return FALSE; } catch (CFileException* pEx) { TCHAR szError[1024]; pEx-GetErrorMessage(szError, 1024); m_strLastError szError; pEx-Delete(); // 清理资源... return FALSE; } }实现细节与技巧缓冲区大小BUFFER_SIZE设置为64KB是一个经验值。太小会增加系统调用次数影响效率太大则可能占用过多内存且每次读写的延迟感知更明显。可以根据实际网络环境微调。进度报告频率控制通过GetTickCount()计算时间差控制每200毫秒才调用一次进度回调。这是至关重要的优化。如果不加控制每读取一个缓冲区就回调一次UI线程可能会被海量的进度更新消息淹没导致界面反而卡顿。速度计算速度计算(字节数 / 时间差)是在工作线程中完成的避免将大量原始数据传递到UI线程进行计算减轻UI线程负担。异常处理CInternetException和CFileException是MFC网络和文件操作可能抛出的异常。必须捕获并获取可读的错误信息这是调试和用户提示的关键。暂停/停止机制使用WaitForSingleObject非阻塞地检查事件对象状态。暂停时线程进入一个短睡眠的循环持续检查暂停事件停止时直接退出函数并清理。这种“协作式”的多线程控制比强制终止线程更安全。3.3 与MFC UI线程的安全通信工作线程不能直接操作UI控件必须通过线程安全的方式将数据“传递”给主线程。我采用了“回调函数内封装PostMessage”的模式。void CFileDownloader::ReportProgress(long long downloaded, long long total) { if (m_fnProgress) { // 计算速度等可以在工作线程算好 double speed 0.0; // 这里需要从成员变量或其他方式获取计算好的速度 // 关键将回调的调用通过PostMessage抛给主线程执行 // 假设主窗口句柄是m_hWndMain自定义消息是WM_DOWNLOAD_PROGRESS // 这里为了简化展示思路。实际项目中回调函数本身可能就是在主线程设置的 // 我们可以在设置回调时要求调用者提供一个安全调用UI的方法例如绑定到控件的成员函数。 // 更通用的做法是ProgressCallback 本身就在主线程的上下文中被调用。 // 我们通过 std::bind 将回调绑定到主窗口类的一个方法上。 // 在工作线程中我们只是将数据准备好然后PostMessage。 // 主窗口的OnDownloadProgress消息处理函数中再调用真正更新UI的代码。 } } // 在主对话框类中 BEGIN_MESSAGE_MAP(CMyDownloadDlg, CDialogEx) ON_MESSAGE(WM_DOWNLOAD_PROGRESS, CMyDownloadDlg::OnDownloadProgress) ON_MESSAGE(WM_DOWNLOAD_STATUS, CMyDownloadDlg::OnDownloadStatus) END_MESSAGE_MAP() LRESULT CMyDownloadDlg::OnDownloadProgress(WPARAM wParam, LPARAM lParam) { // wParam 和 lParam 可以传递进度数据或者传递一个结构体指针 // 这里安全地更新进度条控件 CProgressCtrl* pProg (CProgressCtrl*)GetDlgItem(IDC_PROGRESS); if (pProg) { int nPercent (int)wParam; // 假设传过来的是百分比 pProg-SetPos(nPercent); } // 更新速度文本等... return 0; }重要提示直接在回调函数m_fnProgress里操作UI控件是危险的因为该回调是在工作线程的上下文中被调用的。一种安全的模式是在设置回调时传入一个主窗口类的成员函数通过std::bind这个成员函数内部只做一件事PostMessage到窗口自身。或者更简单清晰的做法是CFileDownloader不直接调用UI更新函数而是通过PostMessage发送自定义消息到主窗口由主窗口的消息处理函数来更新UI。本例中为了展示灵活性设计了回调接口但在实际实现时需要确保回调的执行上下文是主线程。4. 界面集成与用户体验优化有了后台的下载引擎前台的界面集成就是让它好用的关键。4.1 对话框布局与控件绑定创建一个标准的MFC对话框包含以下核心控件编辑框用于输入下载URL。按钮“浏览”按钮选择本地保存路径“开始/暂停/停止”下载控制按钮。进度条控件直观显示下载进度。静态文本用于显示状态信息如“连接中”、“下载中”、“已完成”、已下载/总大小、实时下载速度、预估剩余时间。列表框或编辑框用于显示下载日志或错误信息。在对话框类CMyDownloadDlg中声明一个CFileDownloader成员变量m_downloader并在OnInitDialog中初始化它设置好回调函数这些回调函数内部应使用PostMessage或Invoke机制安全更新UI。4.2 控制逻辑与状态同步按钮的控制逻辑需要与CFileDownloader的状态机同步void CMyDownloadDlg::OnBnClickedButtonStart() { CString strUrl, strPath; GetDlgItemText(IDC_EDIT_URL, strUrl); GetDlgItemText(IDC_EDIT_PATH, strPath); if (strUrl.IsEmpty() || strPath.IsEmpty()) { AfxMessageBox(_T(请输入URL和保存路径)); return; } // 设置回调 (这里使用Lambda但Lambda内必须通过消息通知UI线程) m_downloader.SetCallbacks( [this](long long dl, long long total, double speed) { // 在工作线程中执行不能直接操作UI。 // 将数据打包通过PostMessage发送到主窗口 PostMessage(WM_USER_PROGRESS, (WPARAM)new ProgressData(dl, total, speed), 0); }, [this](CFileDownloader::DownloadStatus stat, const CString msg) { PostMessage(WM_USER_STATUS, (WPARAM)new StatusData(stat, msg), 0); }, [this](bool success, const CString path, const CString error) { PostMessage(WM_USER_COMPLETE, (WPARAM)new CompletionData(success, path, error), 0); } ); if (m_downloader.StartDownload(strUrl, strPath, _T(MyMFC Downloader/1.0))) { GetDlgItem(IDC_BUTTON_START)-EnableWindow(FALSE); GetDlgItem(IDC_BUTTON_PAUSE)-EnableWindow(TRUE); GetDlgItem(IDC_BUTTON_STOP)-EnableWindow(TRUE); } else { AfxMessageBox(_T(开始下载失败)); } } void CMyDownloadDlg::OnBnClickedButtonPause() { if (m_downloader.GetCurrentStatus() CFileDownloader::DS_Downloading) { m_downloader.PauseDownload(); SetDlgItemText(IDC_BUTTON_PAUSE, _T(继续)); } else if (m_downloader.GetCurrentStatus() CFileDownloader::DS_Paused) { m_downloader.ResumeDownload(); SetDlgItemText(IDC_BUTTON_PAUSE, _T(暂停)); } }状态同步要点按钮的启用/禁用状态、文本都需要根据m_downloader.GetCurrentStatus()的返回值来动态更新。这通常在状态回调WM_USER_STATUS的消息处理函数中进行。4.3 进度、速度与剩余时间显示在进度回调的消息处理函数中除了更新进度条位置还可以计算并显示更多信息LRESULT CMyDownloadDlg::OnProgressUpdate(WPARAM wParam, LPARAM lParam) { std::unique_ptrProgressData pData((ProgressData*)wParam); // 用智能指针管理防止内存泄漏 // 1. 更新进度条 CProgressCtrl* pProg (CProgressCtrl*)GetDlgItem(IDC_PROGRESS); if (pProg) { if (pData-total 0) { int nPos (int)((pData-downloaded * 100) / pData-total); pProg-SetPos(nPos); } else { pProg-SetPos(0); // 或设置为Marquee模式表示未知大小 } } // 2. 更新文本已下载/总量 CString strSize; strSize.Format(_T(%s / %s), FormatFileSize(pData-downloaded), pData-total 0 ? FormatFileSize(pData-total) : _T(未知)); SetDlgItemText(IDC_STATIC_SIZE, strSize); // 3. 更新速度 CString strSpeed; if (pData-speed 0) { strSpeed.Format(_T(速度: %s/s), FormatFileSize((long long)pData-speed)); } else { strSpeed _T(速度: --); } SetDlgItemText(IDC_STATIC_SPEED, strSpeed); // 4. 估算剩余时间 (仅当总大小已知且速度0时) if (pData-total 0 pData-speed 1) { double remainingSeconds (pData-total - pData-downloaded) / pData-speed; CString strRemaining FormatTime(remainingSeconds); SetDlgItemText(IDC_STATIC_REMAINING, _T(剩余: ) strRemaining); } else { SetDlgItemText(IDC_STATIC_REMAINING, _T(剩余: --)); } return 0; }FormatFileSize和FormatTime是辅助函数用于将字节数格式化为KB/MB/GB将秒数格式化为时分秒。5. 高级话题与避坑指南在实际开发中总会遇到一些预料之外的问题。下面是我在实现过程中遇到的一些典型问题及解决方案。5.1 HTTPS连接与SSL证书问题如果你下载的URL是https://开头的可能会遇到SSL证书验证错误。默认情况下WinINet会验证服务器证书。对于内部系统或测试环境有时需要忽略证书错误。警告在生产环境中忽略证书验证会带来安全风险仅应在可控的、信任的环境中使用。// 在创建 CInternetSession 时可以设置标志位来忽略某些错误 DWORD dwFlags INTERNET_FLAG_RELOAD | INTERNET_FLAG_TRANSFER_BINARY | INTERNET_FLAG_EXISTING_CONNECT; dwFlags | INTERNET_FLAG_IGNORE_CERT_DATE_INVALID; // 忽略过期日期 dwFlags | INTERNET_FLAG_IGNORE_CERT_CN_INVALID; // 忽略证书名称不匹配 pFile (CHttpFile*)session.OpenURL(strUrl, 1, dwFlags);如果上述标志位还不够你可能需要更深入地干预WinINet的证书验证回调这涉及设置INTERNET_OPTION_SECURITY_FLAGS选项代码会更复杂。一个更彻底的但更不安全的绕过方法是修改INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT或使用InternetSetOption设置SECURITY_FLAG_IGNORE_UNKNOWN_CA等标志。强烈建议查阅最新MSDN文档并充分理解安全后果。5.2 大文件下载与断点续传WinINet本身通过INTERNET_FLAG_RESYNCHRONIZE和Range请求头支持断点续传。实现思路如下检查本地已存在文件开始下载前检查本地目标文件是否存在及其大小。发送带Range头的请求如果文件已存在部分内容在OpenURL后使用CHttpFile::AddRequestHeaders添加Range: bytesxxx-请求头其中xxx是本地文件的当前大小。以追加模式打开本地文件使用CFile::modeCreate | CFile::modeWrite | CFile::modeNoTruncate模式打开文件并将文件指针移动到末尾。处理服务器响应服务器应返回206 Partial Content状态码。如果返回200 OK说明服务器不支持断点续传需要从头下载可能覆盖已存在部分需用户确认。关键代码片段CFile localFile; DWORD dwLocalSize 0; CFileStatus status; if (CFile::GetStatus(strLocalPath, status)) { dwLocalSize (DWORD)status.m_size; } CInternetSession session(...); CHttpFile* pFile (CHttpFile*)session.OpenURL(...); // 先打开连接 if (dwLocalSize 0) { // 添加断点续传请求头 CString strRange; strRange.Format(_T(Range: bytes%lu-), dwLocalSize); pFile-AddRequestHeaders(strRange); // 以追加模式打开文件 localFile.Open(strLocalPath, CFile::modeWrite | CFile::modeNoTruncate); localFile.SeekToEnd(); } else { localFile.Open(strLocalPath, CFile::modeCreate | CFile::modeWrite); } // ... 然后查询状态码 pFile-QueryInfoStatusCode(dwStatusCode); if (dwLocalSize 0 dwStatusCode ! HTTP_STATUS_PARTIAL_CONTENT) { // 服务器不支持断点续传需要处理例如询问用户 }5.3 线程安全与资源清理这是多线程编程中最容易出错的地方。MFC对象与线程CInternetSession、CHttpFile、CFile等MFC对象最好在创建它们的线程中销毁。确保PerformDownload函数在退出前无论成功还是异常都正确关闭和删除了这些对象。回调与UI对象如前所述不要在后台线程中直接访问或修改MFC控件如GetDlgItem、SetWindowText。务必通过消息队列 (PostMessage) 进行通信。事件与临界区m_hEventPause,m_hEventStop等内核对象在类的构造函数中创建 (CreateEvent)在析构函数中关闭 (CloseHandle)。CRITICAL_SECTION同样需要在构造函数中初始化 (InitializeCriticalSection)在析构函数中删除 (DeleteCriticalSection)。线程优雅退出StopDownload函数应设置停止事件然后等待工作线程自然退出例如使用WaitForSingleObject(m_pThread-m_hThread, INFINITE)而不是粗暴地TerminateThread。在线程函数 (DownloadThreadWorker) 的末尾要确保释放线程句柄。5.4 错误处理与日志记录健全的错误处理能让程序更健壮也便于调试。捕获所有异常如代码所示用try...catch块包裹可能抛出CInternetException和CFileException的代码。获取详细错误使用pEx-GetErrorMessage()获取可读的错误描述而不仅仅是错误码。记录日志在关键步骤开始连接、收到响应、开始写入、完成、发生错误和状态变更时将信息输出到日志文件或UI的日志框。这对于排查网络超时、权限不足、磁盘满等问题至关重要。用户友好的提示不要直接将内部错误码如ERROR_INTERNET_NAME_NOT_RESOLVED抛给用户。将其转换为更易懂的文字如“无法解析服务器地址请检查网络连接和URL是否正确”。6. 性能优化与扩展思路当基本功能稳定后可以考虑以下优化和扩展多连接分块下载对于支持HTTP/1.1及以上版本且支持Range的服务器可以创建多个CHttpFile连接分别下载文件的不同部分Range: bytes0-9999,Range: bytes10000-19999...最后合并。这能显著提升大文件的下载速度但复杂度也大大增加需要处理分块、并发、文件合并和错误恢复。下载队列管理将CFileDownloader设计为可管理多个下载任务实现顺序下载或有限并发数的下载。这需要引入一个任务队列和更复杂的线程管理。配置文件与持久化将未完成的下载任务信息URL、本地路径、已下载大小等保存到配置文件或注册表。程序启动时检查并恢复实现程序关闭后的任务恢复。代理服务器支持CInternetSession构造函数可以接受代理服务器信息或者依赖系统IE的代理设置。如果需要自定义代理可以通过InternetSetOption进行更精细的配置。更优雅的暂停/继续当前的暂停机制是“忙等待”Sleep(100)。对于长时间暂停可以考虑使用WaitForSingleObject(m_hEventPause, INFINITE)让线程完全挂起并在ResumeDownload时用SetEvent唤醒它。但要注意挂起期间网络连接可能会超时断开。实现一个MFC下的文件下载功能就像在旧城改造中铺设新的管线需要尊重原有的框架消息循环、GDI对象同时引入现代的理念异步、事件驱动、线程安全。整个过程下来最深的体会是在MFC中做任何超出简单响应式UI的事情都必须把线程安全和消息通信放在第一位考虑。那些看似简单的SetDlgItemText在错误的线程里调用就是崩溃的导火索。另外WinINet虽然老但文档齐全、行为稳定只要把异常处理和资源管理做到位完全能满足企业级应用中对可靠性的要求。最后代码的封装性很重要把下载逻辑、UI更新、控制逻辑清晰地分离未来无论是替换网络库比如换成libcurl还是增加新功能比如下载队列都会从容很多。
