基于.NET FileSystemWatcher的PowerShell FTP编排器挂起问题求助

哥们，我太懂你这种头疼的感觉了——用FileSystemWatcher做监控，本来好好的，突然就悄无声息挂掉，连日志都没个说法，完全没规律可言！结合你用PowerShell做FTP编排器、调用其他脚本处理文件的场景，给你几个实打实的排查和解决方向：

1. 先堵上FileSystemWatcher的经典坑 #

• 内部缓冲区溢出：虽然你觉得和文件数量无关，但有时候短时间内高频触发事件（哪怕单批次文件少），会导致Watcher的默认8KB缓冲区溢出，直接停止触发后续事件。可以手动调大缓冲区（上限64KB）：

$watcher = New-Object System.IO.FileSystemWatcher
$watcher.InternalBufferSize = 65536  # 设为64KB

• 事件线程被阻塞/异常吞掉：如果你的文件处理脚本耗时久、或者抛出未捕获的异常，会直接卡死Watcher的事件处理线程，导致后续事件完全没反应。一定要给事件Action加强制异常捕获，哪怕把错误硬写到日志里：

Register-ObjectEvent $watcher Created -Action {
    try {
        $filePath = $Event.SourceEventArgs.FullPath
        Write-Log "开始处理文件: $filePath"
        & .\你的处理脚本.ps1 $filePath
        Write-Log "文件处理完成: $filePath"
    }
    catch {
        # 哪怕日志模块出问题，也要确保错误能落地
        $errorMsg = "[$(Get-Date)] 处理失败: $($_.Exception.Message) | 文件: $($Event.SourceEventArgs.FullPath)"
        $errorMsg | Out-File -Append C:\WatcherErrorBackup.log
        Write-Log $errorMsg
    }
}

另外，别在事件Action里做耗时操作（比如大文件FTP上传、解压），把任务丢到后台Job异步处理，避免阻塞Watcher线程：

# 在Action里启动后台Job
Start-Job -ScriptBlock {
    param($filePath)
    try {
        & .\你的处理脚本.ps1 $filePath
    }
    catch {
        # 后台Job里也要加日志
        "[$(Get-Date)] Job处理失败: $($_.Exception.Message)" | Out-File -Append C:\JobError.log
    }
} -ArgumentList $Event.SourceEventArgs.FullPath

2. 排查PowerShell会话的隐性问题 #

• 内存泄漏导致会话崩溃：长时间运行的PowerShell会话，频繁调用脚本、创建对象容易出现内存泄漏，最终导致整个进程僵死。可以给编排器加个自我监控重启机制：比如定时检查Watcher的事件注册状态，或者监控一个“心跳”文件（比如每5分钟写个时间戳到文件），如果发现心跳停滞，就自动重启脚本。
• 权限突发变化：如果FTP文件夹的ACL被修改，或者运行脚本的账户权限临时失效，Watcher会失去访问权限，悄悄停止工作。可以在日志里定期记录当前账户对监控文件夹的权限，或者用Get-Acl做定时校验。

3. 给日志加个兜底方案 #

你说日志模块没记录，说明Watcher挂的时候连日志系统都没法正常工作了。可以加个双重保险：

• 开启PowerShell会话转录：Start-Transcript -Path C:\WatcherFullSession.log -Append，这样整个会话的所有输出（包括底层错误）都会被记录下来，哪怕你的自定义日志模块挂了，也能找到线索。
• 在事件Action里加最原始的文件输出，比如：

"[$(Get-Date)] 触发Created事件: $($Event.SourceEventArgs.FullPath)" >> C:\WatcherDebugRaw.log

4. 尽量复现问题的小技巧 #

因为问题无规律，难复现，可以试试：

• 模拟高负载：批量生成测试文件，高频触发Watcher事件，看能不能快速复现挂起；
• 换PowerShell版本测试：比如在PS5.1和PS7.x分别运行，看是不是版本特定的bug；
• 查系统日志：用Get-WinEvent查看Windows日志里的.NET Runtime、PowerShell相关错误，有时候Watcher挂掉会在这里留下崩溃记录。

内容的提问来源于stack exchange，提问作者Szymon Masłowski