PowerShell的Out-File是否会静默失败导致无法写入文件行？

Out-File是否会静默失败？ #

是的，Out-File存在不抛出异常就静默失败的场景，常见情况包括：

• 文件被其他进程独占锁定（比如Excel正在打开该CSV），此时非终止错误不会触发catch块
• 磁盘临时空间不足或权限临时变更，部分写入操作无异常反馈
• 多线程/并行遍历产品时，多个进程同时写入同一文件导致的写入冲突，部分内容被覆盖或丢失
• 某些非终止错误（如警告级别的错误）默认不会终止执行，也不会进入catch逻辑

如何判断失败并重试？ #

可以通过以下几个步骤解决：

1. 强制将非终止错误转为终止异常 #

在Out-File中添加-ErrorAction Stop参数，让所有错误都触发终止异常，确保能被catch块捕获：

Out-File -Append -FilePath $outputFile -InputObject $csvOutput -ErrorAction Stop

2. 实现重试逻辑 #

添加循环重试机制，设置最大重试次数，每次失败后等待一段时间再尝试：

$maxRetries = 3
$retryCount = 0
$writeSuccess = $false

while (-not $writeSuccess -and $retryCount -lt $maxRetries) {
    try {
        [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12                
        $data = Invoke-RestMethod -Method Get -Uri "https://somewebservice.com"
        
        $csvOutput = ParseToCsv $data

        # 强制抛出所有错误
        Out-File -Append -FilePath $outputFile -InputObject $csvOutput -ErrorAction Stop
        $writeSuccess = $true
    }
    catch {
        $retryCount++
        Write-Host "写入失败，正在重试第 $retryCount 次：$_"
        Start-Sleep -Seconds 2 # 等待2秒后重试
        if ($retryCount -eq $maxRetries) {
            Write-Host "达到最大重试次数，记录失败内容："
            Write-Host $csvOutput -Separator "`n"
        }
    }
}

3. 验证写入结果 #

写入完成后，可以额外验证文件是否包含刚写入的内容，确保写入成功：

# 写入后验证
$outputLines = $csvOutput -split "`n"
$lastLines = Get-Content $outputFile -Tail $outputLines.Count
if ($lastLines -join "`n" -ne $csvOutput) {
    Write-Host "写入内容不匹配，触发重试"
    # 此处可再次调用写入逻辑或记录日志
}

4. 避免并发写入冲突 #

如果你的遍历是并行执行的（比如用ForEach-Object -Parallel），需要添加同步锁，确保同一时间只有一个进程写入文件：

$fileLock = New-Object System.Threading.Mutex($false, "CsvFileWriteLock")

# 在写入前获取锁
$fileLock.WaitOne()
try {
    Out-File -Append -FilePath $outputFile -InputObject $csvOutput -ErrorAction Stop
}
finally {
    # 释放锁
    $fileLock.ReleaseMutex()
}

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