winhttpsetoption 代理

WinHttpSetOption这个API，代理说白了就是代理给Windows的HTTP通信底层拧螺丝。它不直接帮你发请求，代理而是代理控制那些藏在系统深处的代理、超时、代理证书验证规则。代理用过WinHTTP的代理人都知道，这函数签名长得吓人——五个参数，代理一个句柄，代理一个选项常量，代理一个缓冲区指针，代理外加长度和标志位。代理但真正折腾人的代理，是代理它和代理打交道时的那些坑。

举个例子。代理你写了个服务程序，用WinHttpOpen创建会话，再WinHttpOpenRequest准备连接某个API。一切正常，直到你发现请求总是超时。查了半天，发现系统里设了IE代理，而WinHTTP默认不认IE设置——除非你调用WinHttpSetOption，把WINHTTP_OPTION_PROXY这个选项塞进去。可问题是，这个选项必须在WinHttpOpenRequest之前设置，而且必须传一个WINHTTP_PROXY_INFO结构体进去。结构体里三个字段，dwAccessType、lpszProxy、lpszProxyBypass，哪个写错都白搭。

我见过最典型的错误，是有人把lpszProxy设成"http://proxy:8080"这种带协议前缀的写法。WinHTTP的代理字符串压根不认这个，它要的是纯主机名加端口，比如"proxy:8080"。一旦带上前缀，函数返回ERROR_WINHTTP_INVALID_OPTION，你还查不出原因。这种细节，MSDN文档里写得模棱两可，只有踩过坑才记得住。

还有个更隐蔽的坑——代理自动配置脚本。你用WinHttpSetOption设置WINHTTP_OPTION_PROXY时，如果dwAccessType设成WINHTTP_ACCESS_TYPE_AUTOMATIC_PROXY，系统会去读WPAD配置。但WinHTTP的自动代理检测和WinINET不一样，它默认不启用，你得先调用WinHttpGetProxyForUrl拿到代理列表，再手动塞回去。这一来一回，代码量翻倍不说，还容易引入竞态条件——如果你在获取代理结果前就发起请求，那连接就直接走直连了。

说句实话，WinHttpSetOption的代理设置，设计得相当反直觉。它不像WinINET那样能自动继承系统设置，也不像libcurl那样一个选项搞定所有。它逼着你把代理逻辑拆成两步：先探测，再应用。而且探测和应用的时机必须严格同步。我见过一个生产事故，某团队在每次请求前都重新调用WinHttpGetProxyForUrl，结果代理服务器被高频查询打崩了。其实代理配置在短时间内根本不会变，缓存一下就行。

如果你真要跟WinHTTP死磕代理，我的建议是：把WinHttpSetOption封装成一层，专门处理代理逻辑。内部用一个静态缓存保存最后一次成功的WINHTTP_PROXY_INFO，只在网络环境变化时才重新探测。另外，别忘了WINHTTP_OPTION_PROXY_BYPASS_LIST——这个选项可以单独设置绕过列表，免得每次都要拼完整的结构体。但注意，绕过列表的匹配规则是后缀匹配，你写".internal.com"它不会匹配"internal.com"，得带上前面的点。

最后说个玄学。WinHttpSetOption的返回值，你最好每次都用GetLastError检查。它有时候会返回ERROR_SUCCESS但实际没生效——尤其是在设置了WINHTTP_OPTION_PROXY之后又紧接着设置其他选项时。遇到这种情况，别怀疑自己代码写错，先把设置顺序调整一下，让代理选项最后设。这招治好了我不少莫名其妙的线上问题。

(责任编辑：综合)