cURL与Invoke-WebRequest处理Authorization头的差异及问题排查

问题场景 #

使用PowerShell的Invoke-WebRequest调用API时，API返回未提供认证凭证的错误，但相同请求用curl可正常执行，问题集中在Authorization头。

可正常运行的curl命令（Postman生成） #

curl --location 'http://localhost:8000/api/books/v1/books/1' \
--header 'Authorization: Bearer xxx' \
--header 'Content-Type: application/json'

报错的PowerShell命令 #

(Invoke-WebRequest -Uri "http://localhost:8000/api/books/v1/books/1" -Method GET -Headers @{ "Authorization" = "Bearer xxx" }).Content | ConvertFrom-Json | ConvertTo-Json -Depth 10

错误信息 #

Invoke-WebRequest : {"detail":"Authentication credentials were not provided."}
At line:1 char:2
+ (Invoke-WebRequest -Uri "http://localhost:8000/api/books/v1/books/1"  ...
+  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (System.Net.HttpWebRequest:HttpWebRequest) [Invoke-WebRequest], WebException
    + FullyQualifiedErrorId : WebCmdletWebResponseException,Microsoft.PowerShell.Commands.InvokeWebRequestCommand

补充信息 #

• Invoke-WebRequest在PowerShell中执行，curl命令由Postman生成并复制
• 已确保Authorization头名称大小写正确
• 因是GET请求，已移除-ContentType "application/json"头
• 已验证令牌复制正确，无隐藏字符

核心疑问 #

• cURL与Invoke-WebRequest处理请求头（尤其是Authorization头）有何差异？
• 为何API接受curl请求却拒绝Invoke-WebRequest？
• Invoke-WebRequest是否有特定行为或设置导致该差异？

原因分析与解决方案 #

1. 版本相关的请求头处理差异 #

在PowerShell 5.1及更早版本中，Invoke-WebRequest基于System.Net.HttpWebRequest，它会自动修改或标准化请求头格式，比如部分场景下会误将Bearer类型的Authorization头按基本认证规则处理，导致头内容被篡改。而curl会严格按照用户指定的内容发送请求头，无额外自动处理。

2. 替代方案：使用Invoke-RestMethod #

Invoke-RestMethod在请求头处理上更贴近curl的行为，且专为API交互设计，替换命令后大概率能解决问题：

Invoke-RestMethod -Uri "http://localhost:8000/api/books/v1/books/1" -Method GET -Headers @{ "Authorization" = "Bearer xxx" } | ConvertTo-Json -Depth 10

3. 手动创建HttpWebRequest对象（针对PowerShell 5.1） #

如果必须使用Invoke-WebRequest，可以直接实例化HttpWebRequest对象手动设置头，规避自动处理逻辑：

$request = [System.Net.HttpWebRequest]::Create("http://localhost:8000/api/books/v1/books/1")
$request.Method = "GET"
$request.Headers.Add("Authorization", "Bearer xxx")
$response = $request.GetResponse()
$reader = New-Object System.IO.StreamReader($response.GetResponseStream())
$content = $reader.ReadToEnd()
$reader.Close()
$response.Close()
$content | ConvertFrom-Json | ConvertTo-Json -Depth 10

4. 禁用自动解析与代理干扰 #

PowerShell可能会调用IE引擎自动处理请求，或使用系统代理干扰头信息，添加-UseBasicParsing参数可禁用该行为：

Invoke-WebRequest -Uri "http://localhost:8000/api/books/v1/books/1" -Method GET -Headers @{ "Authorization" = "Bearer xxx" } -UseBasicParsing

总结 #

两者的核心差异在于：curl严格遵循用户指定的请求头发送，而PowerShell 5.1及更早版本的Invoke-WebRequest依赖的HttpWebRequest会对请求头做额外标准化或自动处理，可能导致Bearer令牌头未正确传递。使用Invoke-RestMethod或手动操作HttpWebRequest对象是最直接的解决方式。

内容的提问来源于stack exchange，提问作者notalentgeek