WebSocket 那篇文章讲的是双向实时通信,但日常自动化场景里用到最多的还是HTTP 请求——API 调用、数据采集、文件下载、服务状态检查。v2 没有内置的 UrlDownloadToFile 升级版,但 WinHttp COM 组件在 v2 下比 v1 好用得多。
本文从最基础的 GET 请求开始,一步步深入到异步下载、REST API 封装、OAuth 鉴权、重试机制、并发控制——全部带完整可运行的 v2 代码。
01 WinHttp vs Msxml2: 谁才是你的选择
HTTP 请求在 Windows 上主要通过两个 COM 组件:
| 组件 | CLSID | 特点 | 适用场景 |
|---|---|---|---|
| WinHttp.WinHttpRequest | 自动选择最底层 | 不走 IE 代理栈,性能高,支持异步 | 服务端/后台脚本、大文件下载 |
| Msxml2.XMLHTTP | 走 IE 配置 | 兼容性好,支持同步 | 简单的 API 调用、内网请求 |
选型建议: 默认用 WinHttp——它更底层、更可控、性能更好。只有遇到某些特殊的代理认证场景才换 Msxml2。
; WinHttp 创建方式
whr := ComObject("WinHttp.WinHttpRequest.5.1")
; Msxml2 创建方式
xml := ComObject("Msxml2.XMLHTTP")
02 同步 GET 请求:最基础的 API 调用
一切从最简单的开始——发送 GET 请求获取网页内容。
<!--B2_PLACEHOLDER_0-->
获取 JSON 并解析
实际工作中更常见的是调用 REST API 返回 JSON。v2 用 JSON.parse 解析——注意 v2 没有内置 JSON 库,你需要用 ComObject("htmlfile") 做 eval 或者用第三方 JSON 库。这里给一个不依赖任何外部库的方案:
<!--B2_PLACEHOLDER_1-->
03 POST 请求:发送数据与表单提交
GET 只能拿数据,POST 能提交数据。最常见的场景:API 调用、登录提交、数据推送。
<!--B2_PLACEHOLDER_2-->
04 异步请求:不阻塞界面才是正经事
同步请求会让整个脚本卡住——网络慢的时候你的程序就像死了一样。v2 的 WinHttp 支持异步模式(第三个参数传 true),通过事件回调获得结果。
<!--B2_PLACEHOLDER_3-->
05 大文件下载:带进度条和断点续传
WinHttp 下载大文件不能直接用 ResponseText 塞内存——文件太大的话内存会爆。正确做法是用 ResponseBody 分段写入文件。
<!--B2_PLACEHOLDER_4-->
06 REST API 客户端封装:用类组织 API 调用
实际项目里不会每次都从头写 HTTP 请求——封装一个通用的 API 客户端。
<!--B2_PLACEHOLDER_5-->
07 OAuth 与 Bearer Token 鉴权
现代 API 基本都走 Token 鉴权。最常见的两种模式:
<!--B2_PLACEHOLDER_6-->
08 批量并发请求:信号量控制
同时发很多请求?不能无限制地开——Windows 有并发连接数限制(WinHttp 默认 2 个)。需要一个信号量控制并发数。
<!--B2_PLACEHOLDER_7-->
09 Cookie 管理与会话保持
有些 API 需要 Cookie 维持登录状态。WinHttp 可以手动管理 Cookie。
<!--B2_PLACEHOLDER_8-->
10 实战:GitHub Release 监控器
把前面所有技术串起来——一个完整的 GitHub Release 监控脚本。
<!--B2_PLACEHOLDER_9-->
11 踩坑实录
陷阱1:COM 对象事件在 v2 中的限制
v2 的 ComObject 不支持直接连接事件源(IConnectionPoint)。需要异步时,要么用 SetTimer 轮询 ReadyState(本文的方案),要么用 ComObjConnect——但 ComObjConnect 只适用于支持 IDispatch 事件接口的 COM 对象,WinHttp 不符合这个条件。
; ❌ 这行在 v2 中不会工作
; ComObjConnect(whr, myHandler)
; ✅ 用轮询
SetTimer () => CheckReadyState(), -100
陷阱2:ResponseBody 一次性加载到内存
WinHttp 的 ResponseBody 是整个响应体的 VARIANT 数组——下载 2GB 文件时会把 2GB 全部加载到内存中,然后才写入磁盘。超过 4GB 会直接崩溃。
解决方案: 对于超大文件(>500MB),考虑用 URLDownloadToFile API 或者分段下载。
陷阱3:SetTimeouts 的顺序
; 参数顺序:解析超时、连接超时、发送超时、接收超时
whr.SetTimeouts(5000, 5000, 10000, 30000)
; ↑解析 ↑连接 ↑发送 ↑接收
; 很多人搞错顺序把接收超时放在前面
; 这样会导致连接 30 秒才超时,明显不对
陷阱4:UTF-8 编码问题
发送包含中文的 JSON 时,必须确保 Content-Type 带 charset=utf-8,否则服务端可能乱码:
; ✅ 正确
whr.SetRequestHeader("Content-Type", "application/json; charset=utf-8")
; ❌ 错误——没指定编码
whr.SetRequestHeader("Content-Type", "application/json")
陷阱5:TLS 1.2 支持
旧版 Windows(Win7/Win8)默认 WinHttp 不支持 TLS 1.2,访问 HTTPS 会报错:
; 在请求前强制开启 TLS 1.2
DllCall("winhttp\WinHttpSetOption", "ptr", whr, "uint", 48, "ptr", 0, "uint", 0) ; WINHTTP_OPTION_SECURE_PROTOCOLS
; 或者在注册表中永久启用
; HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
; DefaultSecureProtocols = 0x00000A00
总结
v2 的网络请求虽然要手动调 COM,但封装好了以后用起来并不比 Python 的 requests 模块差多少。
选型速查表:
| 场景 | 方案 |
|---|---|
| 简单 GET 拿数据 | 同步 WinHttp GET,几行搞定 |
| 调用 REST API | 封装 HttpClient 类,带重试+异常处理 |
| 大文件下载 | WinHttp 异步 + ADODB.Stream 分段写入 |
| 批量请求 | ConcurrencyController 控制并发数 |
| 需要鉴权 | OAuth2Client + BearerAuthClient |
| 后台监控 | SetTimer 定时轮询 + TrayTip 通知 |
下一篇文章预告:AutoHotkey v2 进程与内存管理——从 Process 内置函数到 DllCall 读写其他进程内存。

