TeamCity Agent通过PowerShell上传Artifactory失败求助

这种CI环境里跑不通但本地手动正常的情况我遇到过好多次，核心差异基本都在环境上下文、权限或协议兼容性上，咱们一步步来排查解决：

1. 优先排查TLS版本兼容性 #

Artifactory现在基本都要求TLS 1.2及以上，但TeamCity服务进程默认可能还在用旧版TLS协议（比如TLS 1.0），而你本地手动运行时，PowerShell可能已经继承了系统或用户配置的新版TLS。

解决方法：在上传脚本的最开头强制设置TLS版本：

# 启用TLS 1.2，若需要TLS 1.3可追加 -bor [Net.SecurityProtocolType]::Tls13
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

2. 身份验证与权限上下文问题 #

手动运行时用的是你的用户权限，但TeamCity服务默认可能用本地系统账户或专用服务账户，这个账户要么没Artifactory访问权限，要么无法读取你本地存储的凭证。

解决方案： #

• 显式传递凭证：不要依赖本地存储的凭证，在脚本里直接配置（建议用TeamCity构建参数存储敏感信息，避免硬编码）：
  • WebClient方式：

    $webClient = New-Object System.Net.WebClient
    # 方式1：用NetworkCredential
    $webClient.Credentials = New-Object System.Net.NetworkCredential("%artifactory.username%", "%artifactory.password%")
    # 方式2：用Basic Auth头
    $authBase64 = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("%artifactory.username%:%artifactory.password%"))
    $webClient.Headers.Add("Authorization", "Basic $authBase64")
    

  • Invoke-WebRequest方式：

    $authHeader = @{
        Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("%artifactory.username%:%artifactory.password%"))
    }
    Invoke-WebRequest -Uri "%artifactory.upload.url%" -Method Put -InFile "your-file-path" -Headers $authHeader
    

• 检查TeamCity服务账户权限：确保TeamCity运行的服务账户在Artifactory中拥有对应仓库的上传权限。

3. NAnt调用PowerShell的环境差异 #

如果是通过NAnt触发PowerShell脚本，要确保NAnt调用的是正确版本的PowerShell，并且设置了合适的执行策略：

<exec program="powershell.exe">
  <arg value="-ExecutionPolicy"/>
  <arg value="Bypass"/> <!-- 绕过执行策略限制 -->
  <arg value="-File"/>
  <arg value="your-upload-script.ps1"/>
</exec>

如果你的机器装了PowerShell Core，也可以指定pwsh.exe路径，避免用旧版Windows PowerShell。

4. 代理服务器配置差异 #

TeamCity服务的代理配置和你本地用户的代理配置可能不一致，导致连接失败：

• 禁用代理（如果无需代理访问Artifactory）：

  # WebClient
  $webClient.Proxy = $null
  # Invoke-WebRequest
  Invoke-WebRequest -Uri "%artifactory.upload.url%" -Method Put -InFile "your-file-path" -Proxy $null
  

• 需要代理的话，显式配置代理凭证：

  $webClient.Proxy = New-Object System.Net.WebProxy("http://proxy-server:port")
  $webClient.Proxy.Credentials = New-Object System.Net.NetworkCredential("proxy-user", "proxy-pass")
  

5. 捕获详细错误日志定位问题 #

如果以上方法都没解决，在脚本里加异常捕获，输出更详细的错误信息，方便定位：

• WebClient异常捕获：

  try {
    $webClient.UploadFile("%artifactory.upload.url%", "PUT", "your-file-path")
  } catch {
    Write-Host "===== 错误详情 ====="
    Write-Host "错误信息: $_"
    Write-Host "内部异常: $($_.Exception.InnerException)"
    Write-Host "===================="
  }
  

• Invoke-WebRequest异常捕获：

  try {
    Invoke-WebRequest -Uri "%artifactory.upload.url%" -Method Put -InFile "your-file-path" -Headers $authHeader
  } catch {
    Write-Host "===== 错误详情 ====="
    Write-Host "错误信息: $_"
    if ($_.Exception.Response) {
      Write-Host "响应状态码: $($_.Exception.Response.StatusCode)"
      Write-Host "响应内容: $($_.Exception.Response.Content.ReadAsStringAsync().Result)"
    }
    Write-Host "===================="
  }
  

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