PowerShell脚本写入网络共享日志文件间歇性故障的健壮性提升咨询

针对你遇到的网络共享日志偶尔写入失败的问题，这里有几个实用的优化方案：

1. 改用Add-Content替代Out-File #

Out-File在处理网络文件追加时，偶尔会因为文件锁定或网络延迟出现异常，而Add-Content专门针对追加场景做了优化，兼容性更好。替换后的代码：

Add-Content -LiteralPath $logfile -Value "`nRead the page count"

2. 给写入操作加重试机制 #

既然只是偶尔失败，给写入逻辑加个重试循环，遇到错误时重试几次，大概率能解决偶发问题：

$retryCount = 3
$success = $false
while (-not $success -and $retryCount -gt 0) {
    try {
        Add-Content -LiteralPath $logfile -Value "`nRead the page count" -ErrorAction Stop
        $success = $true
    }
    catch {
        $retryCount--
        Start-Sleep -Milliseconds 500 # 间隔0.5秒重试
        if ($retryCount -eq 0) {
            # 重试失败可以记录到本地临时日志，避免丢失关键信息
            Add-Content -LiteralPath "C:\temp\local_fallback.log" -Value "[$(Get-Date)] 写入网络日志失败: $_"
        }
    }
}

3. 先写本地临时文件，最后同步到网络 #

频繁读写网络文件容易触发各种网络问题，不如先把日志写到本地临时文件，脚本执行完成后再一次性复制到网络共享，减少网络交互次数：

# 初始化本地临时日志
$localLog = "C:\temp\script_local.log"
if (Test-Path $localLog) { Remove-Item $localLog }

# 脚本内所有日志写入本地
Add-Content -LiteralPath $localLog -Value "`nRead the page count"

# 脚本执行完成后同步到网络
try {
    Copy-Item -Path $localLog -Destination $logfile -Force -ErrorAction Stop
}
catch {
    Write-Warning "同步日志到网络失败: $_"
}

4. 用.NET类显式控制文件访问 #

如果需要更精细的文件操作控制，可以直接用.NET的FileStream和StreamWriter，手动管理文件的打开和关闭，避免PowerShell cmdlet的隐式处理带来的问题：

$logMessage = "`nRead the page count"
$encoding = [System.Text.Encoding]::UTF8

try {
    # 打开文件，指定追加模式、共享读权限、读写访问
    $stream = [System.IO.File]::Open($logfile, [System.IO.FileMode]::Append, [System.IO.FileAccess]::Write, [System.IO.FileShare]::Read)
    $writer = New-Object System.IO.StreamWriter($stream, $encoding)
    $writer.WriteLine($logMessage)
}
finally {
    # 确保流和写入器被正确关闭
    if ($writer) { $writer.Close() }
    if ($stream) { $stream.Close() }
}

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