AutoHotkey v2 网络请求(WinHttp)深度实战:从GET/POST到异步下载与REST API集成

WebSocket 那篇文章讲的是**双向实时通信**,但日常自动化场景里用到最多的还是**HTTP 请求**——API 调用、数据采集、文件下载、服务状态检查。v2 没有内置的 `UrlDownloadToFile` 升级版,但 WinHttp COM 组件在 v2 下比 v1 好用得多。...

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 读写其他进程内存。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

给TA捐赠
共{{data.count}}人
人已捐赠
教程

AutoHotkey v2 剪贴板操作(Clipboard)深度实战:从文本到文件到自定义格式

2026-7-18 7:28:38

教程

AutoHotkey v2 文件与目录操作深度实战:File对象、流式读写与文件系统监控

2026-7-20 7:33:37

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
❯
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索