PowerShell中Invoke-RestMethod加请求体遇‘Bad Request’错误求助

嘿，我碰到过好多次Invoke-RestMethod返回"Bad Request"的情况，大多是请求格式、数据和API要求不匹配导致的，咱们一步步排查解决：

1. 请求体格式与API要求不匹配（最常见） #

很多API默认要求JSON格式的请求体，但如果直接传PowerShell对象，它会默认转成x-www-form-urlencoded格式，这就会触发错误。

错误示例：

$requestModel = @{Name = "TestItem"; Quantity = 5}
Invoke-RestMethod -Uri "https://your-api-endpoint.com/create" -Method Post -Body $requestModel

修复办法：把对象序列化为JSON，并指定Content-Type头：

$requestModel = @{Name = "TestItem"; Quantity = 5} | ConvertTo-Json
Invoke-RestMethod -Uri "https://your-api-endpoint.com/create" -Method Post -Body $requestModel -ContentType "application/json"

注意：如果模型有嵌套对象，记得加上-Depth参数（比如ConvertTo-Json -Depth 10），避免嵌套字段被截断。

2. 请求模型字段不符合API规范 #

仔细核对API文档，确保你的模型满足以下要求：

• 字段名大小写是否匹配（很多API区分大小写，比如要求user_id而不是UserId）
• 必填字段是否全部提供，没有遗漏
• 字段类型是否正确（比如数字不能传字符串，日期格式要符合API要求的yyyy-MM-dd或ISO格式）

3. URL参数错误或未编码 #

如果请求带URL查询参数，检查参数名、值是否正确，特殊字符（空格、&、=等）是否编码：

$paramValue = "Laptop Pro 15"
$encodedValue = [Uri]::EscapeDataString($paramValue)
$uri = "https://your-api-endpoint.com/search?product=$encodedValue"
Invoke-RestMethod -Uri $uri -Method Get

4. HTTP方法使用错误 #

确认你用的-Method参数（Get/Post/Put/Delete等）是否符合API的要求。比如API要求用Post提交数据，你误用了Get，就会返回Bad Request。

5. 缺少必要的请求头 #

有些API需要特定的头信息，比如授权令牌、API密钥、Accept头。示例：

$headers = @{
    "Authorization" = "Bearer YOUR_ACCESS_TOKEN"
    "X-API-Key" = "YOUR_API_KEY"
    "Accept" = "application/json"
}
Invoke-RestMethod -Uri "https://your-api-endpoint.com/data" -Method Get -Headers $headers

6. 调试查看具体错误信息 #

如果以上排查都没解决，用try-catch捕获异常，查看API返回的详细错误内容：

try {
    Invoke-RestMethod -Uri "https://your-api-endpoint.com/create" -Method Post -Body $requestModel -ContentType "application/json"
} catch {
    $errorStream = $_.Exception.Response.GetResponseStream()
    $reader = New-Object System.IO.StreamReader($errorStream)
    $errorDetails = $reader.ReadToEnd()
    Write-Host "API返回的具体错误：$errorDetails"
}

API通常会在响应里说明具体问题，比如"缺少必填字段quantity"或"日期格式无效"，能帮你快速定位问题。

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