PowerShell日志文件占用异常及写入重试方案咨询

嗨，我来帮你捋捋这个问题！你遇到的文件占用问题其实挺常见的，虽然[System.IO.File]::AppendAllText本身会自动处理文件的打开和关闭，但偶尔会因为系统层面的原因——比如杀毒软件实时扫描日志文件、Windows文件缓存延迟，甚至是短时间内频繁创建写入日志时的锁竞争——导致文件锁没有及时释放，就会出现第二次运行脚本时的占用报错。

下面给你一套具体的解决方案，既能处理文件占用问题，又能给写入失败的情况加上重试机制：

一、优化日志写入函数，添加重试逻辑 #

我给你的Write-Log函数加了重试机制，专门针对文件占用这类IO异常做重试，同时优化了一些细节：

Function Write-Log {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory = $False)]
        [ValidateSet("INFO", "WARN", "ERROR", "FATAL", "DEBUG")]
        [String]
        $Level = "INFO",
        [Parameter(Mandatory = $True)]
        [string]
        $Message,
        [Parameter(Mandatory = $False)]
        [string]
        $logfile,
        [Parameter(Mandatory = $False)]
        [int]
        $RetryCount = 3,
        [Parameter(Mandatory = $False)]
        [int]
        $RetryDelayMs = 500
    )

    $stampp = Get-Date -Format dd-MM-yyyy-HH-mm-ss
    $Line = "$Stampp $Level $Message`r`n"

    If (-not [string]::IsNullOrEmpty($logfile)) {
        $attempts = 0
        $success = $false
        while ($attempts -lt $RetryCount -and -not $success) {
            try {
                # 确保日志文件存在（第一次写入时自动创建）
                if (-not (Test-Path $logfile)) {
                    New-Item -Path $logfile -ItemType File -Force | Out-Null
                }
                # 明确指定UTF8编码，避免环境差异
                [System.IO.File]::AppendAllText($logfile, $Line, [System.Text.Encoding]::UTF8)
                $success = $true
            }
            catch [System.IO.IOException] {
                # 只针对文件占用这类IO异常重试
                $attempts++
                Write-Warning "写入日志失败（第 $attempts/$RetryCount 次尝试）：$($_.Exception.Message)"
                Start-Sleep -Milliseconds $RetryDelayMs
            }
            catch {
                # 其他未知错误直接抛出，不再重试
                Write-Error "写入日志发生未知错误：$($_.Exception.Message)"
                break
            }
        }
        if (-not $success) {
            Write-Error "已重试 $RetryCount 次，仍无法写入日志文件：$logfile"
        }
    }
    else {
        Write-Output $Line
    }
}

二、完善日志创建函数，避免全局变量问题 #

你的Createlog函数原来依赖全局变量传递日志路径，容易出现意外问题，我改成了返回日志路径的方式，更稳妥：

function CreateLog {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory = $False)]
        [string]
        $CreateLog = "yes",
        [Parameter(Mandatory = $True)]
        [string]
        $FilesPath
    )

    if ($CreateLog -ne "no") {
        try {
            $subfolder = "PatchVerificationLogs"
            # 用Join-Path拼接路径，避免手动拼接的格式错误
            $Logs = Join-Path -Path $FilesPath -ChildPath $subfolder
            if (!(Test-Path -Path $Logs)) {
                New-Item -Path $Logs -ItemType Directory -Force | Out-Null
            }
            $Stamp = Get-Date -Format dd-MM-yyyy-HH-mm-ss
            $hostname = $env:computername
            $UserName = $env:USERNAME
            $logName = "$hostname-$Stamp.log"
            $loglocation = Join-Path -Path $Logs -ChildPath $logName
            return $loglocation
        }
        catch {
            Write-Error "创建日志目录/文件失败：$($_.Exception.Message)"
            return $null
        }
    }
    else {
        return $null
    }
}

三、使用方式调整 #

现在调用的时候，直接接收CreateLog返回的路径即可，不用依赖全局变量：

# 替换成你的实际FilesPath路径
$loglocation = CreateLog -FilesPath "C:\Your\Files\Path"
if ($loglocation) {
    Write-Log -logfile $loglocation -Level INFO -Message "脚本开始执行"
    # 其他日志写入操作...
}

额外建议 #

1. 如果还是偶尔出现文件占用，可以尝试把重试次数和延迟时间调大一点，比如重试5次，每次延迟1000ms
2. 检查一下是否有杀毒软件或者其他监控工具在扫描PatchVerificationLogs目录，有的话可以把这个目录加入排除项
3. 脚本结束时不需要手动关闭日志文件，AppendAllText已经会自动释放文件句柄，除非你用了其他方式打开文件

备注：内容来源于stack exchange，提问作者Bandit