调用ValidatePackage函数时出现400 Bad Request错误求助

常见错误原因及对应解决方法 #

• 手动构造multipart请求破坏二进制数据
  原代码将二进制文件转成iso-8859-1字符串后拼接请求体，会破坏部分二进制字节，导致服务器无法解析文件内容。
  解决：放弃手动构造请求体，使用PowerShell内置的-Form参数自动处理multipart表单，示例：

  $Form = @{
      file = Get-Item -Path $FilePath
  }
  $ValidateResponse = Invoke-RestMethod -Uri $APIVURL -Method Post -Headers $VHeaders -Form $Form
  

• 请求体格式拼接不符合HTTP规范
  手动拼接的multipart内容中，边界分隔、换行符的使用可能存在错误，服务器无法正确解析请求体。
  解决：使用-Form或-InFile参数让PowerShell自动生成符合规范的请求体，避免手动拼接出错。

• 文件路径无效或文件不存在
  $FilePath的拼接可能存在错误（如环境变量未定义、文件夹名称拼写错误），导致读取的文件为空或不存在，服务器收到无效请求返回400。
  解决：添加文件存在校验逻辑：

  if (-not (Test-Path -Path $FilePath -PathType Leaf)) {
      throw "指定文件不存在：$FilePath"
  }
  

• 编码方式与服务器要求不匹配
  原代码用iso-8859-1编码二进制文件，可能与服务器期望的文件编码不匹配，导致文件内容解析失败。
  解决：直接发送二进制文件，不做字符串转换，使用-InFile参数示例：

  $ValidateResponse = Invoke-RestMethod -Uri $APIVURL -Method Post -Headers $VHeaders -InFile $FilePath -ContentType "application/octet-stream"
  

修正后的完整函数示例 #

function ValidatePackage([String] $MeridiumToken, [String] $PackageName, [String] $DNSURL) {
    try {
        Write-Host "Package Validation Process Started for - $PackageName...."
        $APIVURL = $DNSURL + '/api/v1/core/metadata/import/validatemetadata'
        Write-Host $APIVURL

        # 拼接文件路径（用Join-Path避免路径分隔符问题）
        $FilePath = Join-Path -Path "$($env:SYSTEM_DEFAULTWORKINGDIRECTORY)/Subtract-a-thon/Automation" -ChildPath $PackageName

        # 检查文件是否存在
        if (-not (Test-Path -Path $FilePath -PathType Leaf)) {
            throw "文件不存在：$FilePath"
        }

        # Request Headers
        $VHeaders = @{ 'MeridiumToken' = $MeridiumToken }

        # 使用Form参数自动构建合法的multipart请求
        $Form = @{
            file = Get-Item -Path $FilePath
        }

        # REST Call
        Write-Host "Validating Package..."
        $ValidateResponse = Invoke-RestMethod -Uri $APIVURL -Method Post -Headers $VHeaders -Form $Form
        $PkgItems = $ValidateResponse | ConvertTo-Json
        Write-Host "Package Validation Process Finished for -" $PackageName
        if ($PkgItems.StartsWith("{")) {
            $PkgItems = "[$PkgItems]"
        }
        return $PkgItems
    }
    catch {
        Write-Host "An error occurred:"
        Write-Host $_.ScriptStackTrace
        throw $_
    }
}

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