WinInet中HttpAddRequestHeaders与HttpSendRequest设置请求头的差异及优化

嘿，我来帮你把WinInet里这两个设置请求头的方法讲明白，再给你推荐个能避免混用的统一方案～

这俩方法核心都是给HTTP请求加头，但在调用时机、控制粒度和生效逻辑上有不小区别：

• 调用时机与生效阶段

  • HttpAddRequestHeaders必须在创建HttpOpenRequest句柄之后、调用HttpSendRequest之前执行，它直接修改请求句柄内部维护的请求头集合。你可以多次调用它，甚至通过dwFlags参数（比如HTTP_ADDREQ_FLAG_REPLACE）来替换已存在的同名头，灵活性拉满。
  • HttpSendRequest的lpHeaders参数是在发送请求的最后一步传入额外头信息，这些头会和之前用HttpAddRequestHeaders设置的内容合并。如果出现同名头，默认情况下WinInet会把两个都塞进请求里——除非你之前用HttpAddRequestHeaders做了替换操作，或者这个头是WinInet自动生成的默认头（比如Host），这时候可能会被覆盖，行为不太稳定。

• 控制粒度与复杂度

  • HttpAddRequestHeaders支持单个头字段的精细化操作：比如给Cookie头追加新的键值对，或者替换掉User-Agent这种默认头，不用管其他头的内容。
  • HttpSendRequest的lpHeaders是一整段用\r\n分隔的字符串，只能一次性传入所有头，没法单独修改某个字段，要是后续要调整某个头，就得重新拼接整个字符串，很麻烦。

• 默认头的处理
  WinInet会自动添加一些默认头（比如Host、User-Agent），用HttpAddRequestHeaders可以明确替换这些默认值（通过对应标志）；但如果用HttpSendRequest的lpHeaders传入同名默认头，WinInet可能会直接忽略你的设置，不同版本的表现还可能不一致，可靠性差一些。

想要避免混用两种方式，推荐下面两种方案，优先选第一种：

方案一：完全用HttpAddRequestHeaders构建所有请求头 #

这是最稳妥的方式，能精确控制每个请求头的行为，步骤也清晰：

1. 用HttpOpenRequest创建请求句柄时，不用传入任何头信息。
2. 多次调用HttpAddRequestHeaders逐个添加/修改需要的头：

   // 添加Content-Type头
   HttpAddRequestHeaders(hRequest, L"Content-Type: application/json\r\n", -1, HTTP_ADDREQ_FLAG_ADD);
   // 替换默认的User-Agent头
   HttpAddRequestHeaders(hRequest, L"User-Agent: MyCustomAgent/1.0\r\n", -1, HTTP_ADDREQ_FLAG_REPLACE | HTTP_ADDREQ_FLAG_COALESCE);
   // 追加Authorization头
   HttpAddRequestHeaders(hRequest, L"Authorization: Bearer my-token-123\r\n", -1, HTTP_ADDREQ_FLAG_ADD);
   

3. 最后调用HttpSendRequest时，把lpHeaders设为NULL，dwHeadersLength设为0，这样就完全用之前设置的头发送请求。

方案二：构建完整头字符串，在HttpSendRequest中一次性传入 #

如果觉得多次调用麻烦，也可以提前把所有头拼接成一个完整字符串，然后在发送时传入：

// 拼接所有需要的请求头，每个头用\r\n分隔
wchar_t szFullHeaders[] = L"Content-Type: application/json\r\nUser-Agent: MyCustomAgent/1.0\r\nAuthorization: Bearer my-token-123\r\n";
// 发送请求时传入完整头字符串
HttpSendRequest(hRequest, szFullHeaders, wcslen(szFullHeaders), lpPostData, dwPostDataLength);

⚠️ 注意：这种方式下WinInet还是会自动添加部分默认头（比如Host），如果要覆盖这些默认值，还是得先用HttpAddRequestHeaders做替换操作，否则可能达不到预期效果。

总的来说，方案一的可控性更强，能避免混用带来的各种潜在问题，更推荐你使用。

内容的提问来源于stack exchange，提问作者Carlos B. Feitoza Filho