Jenkins执行PowerShell脚本上传Zip至Azure失败，仅第二部分报错

我之前也碰到过类似Jenkins+Azure部署的坑，结合你的场景——本地PowerShell能正常跑通清理+上传，但Jenkins执行时只有清理成功、上传Zip报错，这种「本地正常、CI环境拉胯」的问题，大概率和执行上下文权限、环境变量差异或者脚本里的细节格式问题有关，给你几个具体的排查和解决方向：

1. 先排查Jenkins的运行权限与文件路径问题 #

Jenkins默认是用「本地系统账户（Local System）」运行的，这个账户和你本地登录的用户权限完全不一样：

• 它可能没有读取Jenkins工作目录里Zip包的权限，也可能没有访问Azure资源的正确权限；
• 另外，脚本里如果用了相对路径指向Zip包，Jenkins的工作目录和你本地的工作目录肯定不一样，直接用相对路径会找不到文件。

解决方案：

• 把Jenkins服务的运行账户改成你本地测试用的那个有Azure权限的用户：在服务管理器里找到Jenkins，右键「属性」→「登录」→选择「此账户」，输入你的用户名和密码，重启Jenkins服务；
• 脚本里明确用绝对路径指向Zip包，Jenkins的工作区路径可以用环境变量$env:WORKSPACE获取，比如：

  $zipPath = "$env:WORKSPACE\your-deploy-package.zip"
  # 先校验文件是否存在，避免白忙活
  if (-not (Test-Path $zipPath)) {
      Write-Error "Zip包不存在：$zipPath"
      exit 1
  }
  

2. 修复Azure认证的Base64编码细节 #

你脚本里的$base64AuthInfo是用户名密码生成的，本地和Jenkins的PowerShell环境在编码处理、变量解析上可能有差异，导致认证信息无效：

• 用户名里的$符号，用双引号包裹时Jenkins可能会把$347当成变量解析，建议用单引号包裹避免解析问题；
• 生成Base64时明确指定UTF-8编码，避免不同环境默认编码不一致。

修改后的认证代码：

# 用单引号包裹用户名，防止$符号被当成变量解析
$username = '$347testpass'
$password = 'xyz'
# 明确指定UTF-8编码生成Base64认证串
$authString = "$username`:$password"
$authBytes = [System.Text.Encoding]::UTF8.GetBytes($authString)
$base64AuthInfo = [System.Convert]::ToBase64String($authBytes)

3. 补全上传Zip的Kudu API调用细节 #

你没贴完整的上传代码，通常Azure网站部署用的是Kudu API，上传Zip时需要严格符合API要求，Jenkins里的PowerShell版本如果和本地不一样，Invoke-RestMethod的参数行为可能有差异：

标准的Kudu上传Zip代码示例：

$kuduApiUrl = "https://你的应用名.scm.azurewebsites.net/api/zip/site/wwwroot/"
$headers = @{
    Authorization = "Basic $base64AuthInfo"
    "Content-Type" = "application/zip"
}

# 用Invoke-RestMethod发起PUT请求上传Zip
try {
    Invoke-RestMethod -Uri $kuduApiUrl -Headers $headers -Method PUT -InFile $zipPath -ErrorAction Stop
    Write-Host "Zip包上传成功！"
} catch {
    Write-Error "上传失败：$($_.Exception.Message)"
    exit 1
}

另外，在Jenkins的PowerShell构建步骤里加上-NoProfile参数，避免加载本地的PowerShell配置，减少环境差异：

powershell -NoProfile -File 你的部署脚本.ps1

4. 开启日志排查细节问题 #

如果还是找不到根因，就在脚本里加日志输出，Jenkins构建日志里会显示具体错误：

# 输出当前工作目录、Zip文件是否存在等信息
Write-Host "当前工作目录：$(Get-Location)"
Write-Host "Zip包是否存在：$(Test-Path $zipPath)"
# 注意：生产环境不要输出Base64认证信息，这里只是排查用
Write-Host "Base64认证串：$base64AuthInfo"

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