如何在FTP中使用VSTS变量（含安全变量）及脚本报错排查

从你提供的脚本和报错信息来看，这个模糊的错误通常是由于某个属性赋值失败或者操作权限不足导致的，我们可以一步步排查并修复：

一、先排查WinSCP SessionOptions的配置问题 #

这个错误大概率出在WinSCP的SessionOptions初始化阶段，尤其是SshHostKeyFingerprint属性的格式是否合规：

• 确保你的SshHostKeyFingerprint变量格式符合WinSCP要求，比如应该是类似 ssh-rsa 2048 xx:xx:xx:... 或者带完整算法标识的指纹字符串，而非仅传指纹哈希部分。
• 检查HostName、UserName、Password这些变量是否从VSTS正确传递，有没有空值或者特殊字符未转义的情况。

可以在WinSCP初始化前添加调试输出，确认变量值：

Write-Host "Debug: HostName=$HostName, UserName=$UserName, SshHostKeyFingerprint=$SshHostKeyFingerprint"

二、修复Git推送的URL格式问题 #

你的Git推送URL存在两个潜在问题：

1. URL中写死的Personal%20Access%20Token是多余的，应该直接使用变量$PersonalAccessToken；
2. 旧版visualstudio.com的URL格式在部分环境中可能存在编码问题，推荐使用更稳定的新版格式。

修改推送命令为：

# 新版VSTS URL格式（推荐）
$gitRemoteUrl = "https://$GitUserName`:$PersonalAccessToken@dev.azure.com/mycompany/$VSTSProjectName/_git/$VSTSProjectName"
# 旧版格式兼容
# $gitRemoteUrl = "https://$PersonalAccessToken@mycompany.visualstudio.com/_git/$VSTSProjectName"
git push $gitRemoteUrl master

注意：PowerShell中变量后跟冒号需要加反斜杠转义，避免被解析为作用域标识。

三、检查文件操作权限和路径问题 #

• 确认D:\a\1\s\路径存在，且脚本拥有读写权限；
• 执行git add .前可以先输出当前目录文件，确认SFTP下载的文件已存在：

Write-Host "Current directory files:"
Get-ChildItem -Path "D:\a\1\s\"

• 避免使用git config --global，CI/CD环境中全局配置可能存在冲突，改用本地仓库配置：

git config user.email $GitUserEmail
git config user.name $GitUserName

四、优化错误捕获，定位具体报错位置 #

当前的错误捕获太宽泛，无法定位具体出错行。可以拆分try块或添加更多调试输出：

# WinSCP操作单独捕获错误
try {
    $session.Open($sessionOptions)
    # ... WinSCP下载逻辑 ...
} catch {
    Write-Host "WinSCP Error: $($_.Exception.Message)"
    exit 1
}

# Git操作单独捕获错误
try {
    Set-Location -Path "D:\a\1\s\"
    # ... Git操作逻辑 ...
} catch {
    Write-Host "Git Error: $($_.Exception.Message)"
    exit 1
}

五、修改后的完整脚本示例 #

Param( 
    [string]$HostName, 
    [string]$UserName, 
    [string]$Password, 
    [string]$SshHostKeyFingerprint, 
    [string]$RemoteFTPFolder, 
    [string]$GitUserEmail, 
    [string]$GitUserName, 
    [string]$PersonalAccessToken, 
    [string]$VSTSProjectName 
)

try { 
    # Load WinSCP .NET assembly 
    Add-Type -Path "C:\Program Files (x86)\WinSCP\WinSCPnet.dll" 

    # Debug: 打印WinSCP参数
    Write-Host "WinSCP Debug Params: Host=$HostName, User=$UserName, Fingerprint=$SshHostKeyFingerprint, RemoteFolder=$RemoteFTPFolder"

    # Setup session options 
    $sessionOptions = New-Object WinSCP.SessionOptions -Property @{ 
        Protocol = [WinSCP.Protocol]::Sftp 
        HostName = $HostName 
        UserName = $UserName 
        Password = $Password 
        SshHostKeyFingerprint = $SshHostKeyFingerprint 
    } 

    $session = New-Object WinSCP.Session 
    try { 
        # Connect 
        $session.Open($sessionOptions) 

        # Download files 
        $transferOptions = New-Object WinSCP.TransferOptions 
        $transferOptions.TransferMode = [WinSCP.TransferMode]::Binary 
        $transferResult = $session.GetFiles($RemoteFTPFolder+"/*", "D:\a\1\s\", $False, $transferOptions) 

        # Throw on any error 
        $transferResult.Check() 

        # Print results 
        foreach ($transfer in $transferResult.Transfers) { 
            Write-Host "Download of $($transfer.FileName) succeeded" 
        } 
    } finally { 
        # Disconnect, clean up 
        $session.Dispose() 
    }

    # Git Operations
    Write-Host "Starting Git operations..."
    Set-Location -Path "D:\a\1\s\"

    # Debug: 打印Git参数
    Write-Host "Git Debug Params: Email=$GitUserEmail, Name=$GitUserName, VSTS Project=$VSTSProjectName"

    # 使用本地Git配置而非全局配置
    git config user.email $GitUserEmail
    git config user.name $GitUserName

    git checkout master
    git pull --rebase origin master

    # 验证文件是否存在
    Write-Host "Files in current directory:"
    Get-ChildItem

    git add .
    git commit -m "Automated changes from SFTP download"

    # 修正Git推送URL
    $gitRemoteUrl = "https://$GitUserName`:$PersonalAccessToken@dev.azure.com/mycompany/$VSTSProjectName/_git/$VSTSProjectName"
    git push $gitRemoteUrl master

    exit 0 
} catch [Exception] { 
    Write-Host "Error: $($_.Exception.Message)"
    Write-Host "Error Stack Trace: $($_.Exception.StackTrace)"
    exit 1 
}

通过以上步骤，你应该能定位到具体的报错位置并解决问题。最常见的原因是WinSCP的指纹格式错误，或者Git推送URL的变量传递/编码问题。

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