使用PowerShell通过Kudu ZipDeploy部署Web应用时遇500内部服务器错误

最近在企业网络环境下，我们尝试用PowerShell通过Kudu的ZipDeploy部署Web应用时碰到了棘手问题：之前运行正常的脚本突然抛出(500)内部服务器错误，但用CURL命令却能顺利完成部署。排查后发现，企业网络要求PowerShell配置代理是环境差异，但真正导致失败的是请求格式的问题。

问题细节 #

• 企业网络环境下，PowerShell必须配置代理才能访问Kudu服务，而CURL无需代理即可正常部署
• 原脚本近期突然失效，查看Kudu日志后发现明确错误提示：Missing content-type boundary

错误原因 #

当我们使用Invoke-WebRequest的-InFile参数，并手动指定ContentType "multipart/form-data"时，PowerShell并不会自动生成multipart请求必需的boundary分隔符。Kudu服务器依赖这个boundary来正确解析上传的zip文件内容，缺少它就会导致服务器无法处理请求，最终返回500错误。

解决方法 #

我们需要手动构建符合multipart/form-data规范的请求内容，包含正确的boundary，同时保留原有代理配置逻辑。修改后的脚本如下：

$username = "*********"
$password = "********"
$pair = "$($username):$($password)"
$encodedCreds = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($pair))
$basicAuthValue = "Basic $encodedCreds"
$Headers = @{ Authorization = $basicAuthValue }
$deployUri = "https://testexploreazurewebsites.scm.azurewebsites.net/api/zipdeploy?isAsync=true"

# 保留原有代理配置逻辑
$proxyUri = [Uri]$null
$proxy = [System.Net.WebRequest]::GetSystemWebProxy()
if ($proxy) {
    $proxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
    $proxyUri = $proxy.GetProxy($deployUri)
}

$sourceFilePath = "FilePath.zip"
$fileContent = [System.IO.File]::ReadAllBytes($sourceFilePath)

# 生成随机boundary分隔符
$boundary = [System.Guid]::NewGuid().ToString()
$LF = "`r`n"

# 手动构建multipart请求体
$bodyLines = (
    "--$boundary",
    "Content-Disposition: form-data; name=`"file`"; filename=`"$(Split-Path $sourceFilePath -Leaf)`"",
    "Content-Type: application/zip$LF",
    [System.Text.Encoding]::UTF8.GetString($fileContent),
    "--$boundary--$LF"
) -join $LF

# 发送符合规范的请求
$responseHeaders = Invoke-WebRequest -Uri $deployUri `
    -Method Post `
    -Proxy $proxyUri `
    -ProxyUseDefaultCredentials `
    -Headers $Headers `
    -ContentType "multipart/form-data; boundary=`"$boundary`"" `
    -Body $bodyLines `
    -TimeoutSec 600000

关键调整点 #

• 手动生成随机boundary值，并在ContentType中明确声明
• 自行构建完整的multipart请求体，包含文件的描述信息、类型和字节内容
• 不再使用-InFile参数，改为通过-Body传递规范的multipart内容

调整后，PowerShell发送的请求就能被Kudu服务器正确解析，顺利完成ZipDeploy部署了。

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