通过PowerShell HTTP请求向Jenkins上传文件参数失败排查

你的PowerShell脚本存在几个关键问题，导致Jenkins无法接收文件参数：

问题点解析 #

1. 手动指定Content-Type导致边界缺失
   当使用Invoke-RestMethod上传文件时，不能手动设置multipart/form-data请求头。PowerShell会自动生成包含正确边界标识的Content-Type，手动设置会丢失边界信息，Jenkins无法正确解析表单数据。

2. 文件读取方式错误
   使用[IO.File]::ReadAllText()会将文件按文本格式读取，若文件是二进制类型（如压缩包、图片）会导致内容损坏。即使是文本文件，Jenkins的File Parameter需要的是文件对象，而非纯文本内容。

3. URL参数拼接错误
   原脚本中&string + $stringParam的写法缺少参数名和等号，正确格式应为&stringParam=$stringParam（需替换为你实际的字符串参数名）。

4. 非文件参数的传递方式不规范
   建议将所有参数（包括CHOICE、字符串参数）放在请求Body中，而非URL拼接，避免编码问题，同时和文件参数统一处理。

修正后的脚本 #

$credPair = "user:token"
$encodedCredentials = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($credPair))
$headers = @{
    "Authorization" = "Basic $encodedCredentials"
    # 移除手动设置的Content-Type，让PowerShell自动生成
}

$choiceParam = "option"
$stringParam = "value"
$filePath = "file_path"

# 构建请求Body，文件参数要传递文件信息对象
$body = @{
    "CHOICE" = $choiceParam
    "stringParam" = $stringParam  # 替换成你实际的字符串参数名
    "File" = Get-Item $filePath   # 此处的"File"要和Jenkins任务中文件参数的名称完全一致
}

$url = "https://server/job/buildWithParameters"

try {
    Invoke-RestMethod -Uri $url -Headers $headers -Method Post -Form $body
    # 注意：这里用-Form参数而非-Body，-Form会自动处理multipart/form-data格式
}
catch {
    Write-Host "StatusCode: " $_.Exception.Response.StatusCode.value__
    Write-Host "StatusDescription: " $_.Exception.Response.StatusDescription
    Write-Host "Error details: " $_.ErrorDetails.Message
    exit 1
}

额外注意事项 #

• 确保Jenkins任务中文件参数的名称和脚本中$body里的"File"完全一致（区分大小写）。
• 如果你的文件是大文件，建议使用Invoke-WebRequest替代Invoke-RestMethod，后者在处理大文件时可能出现内存问题。
• 验证Jenkins用户的权限：确保该用户拥有任务的构建权限，以及File Parameter插件的使用权限。

内容的提问来源于stack exchange，提问作者milk_away.89