FileSystemWatcher未正常销毁问题求助

核心问题是FileSystemWatcher实例未被正确销毁+进程残留，导致重复触发文件移动操作，以下是针对性的排查和解决步骤：

1. 全局持有Watcher实例并显式清理 #

很多时候旧实例没被销毁，是因为没有保留全局引用，或者重启脚本时未主动调用Dispose。

实现方式： #

• 用全局集合存储所有Watcher实例，启动脚本前先遍历清理旧实例：

# 全局存储Watcher实例
if (-not $global:fileWatchers) {
    $global:fileWatchers = @()
}

# 启动前强制清理旧实例
foreach ($watcher in $global:fileWatchers) {
    # 先关闭事件触发，再释放资源
    $watcher.EnableRaisingEvents = $false
    $watcher.Dispose()
}
$global:fileWatchers = @()

# 创建新Watcher时加入全局集合
$newWatcher = New-Object System.IO.FileSystemWatcher -Property @{
    Path = "监控路径"
    Filter = "*.*"
    IncludeSubdirectories = $true
    EnableRaisingEvents = $true
}
# 绑定事件处理逻辑...
$global:fileWatchers += $newWatcher

2. 处理服务/脚本的终止信号（针对NSSM服务场景） #

NSSM管理的PowerShell服务如果没正确响应终止信号，会导致旧进程残留，进而保留旧Watcher实例。

实现方式： #

给脚本添加终止事件处理，确保服务停止时能主动清理Watcher：

# 创建终止信号等待对象
$exitEvent = New-Object System.Threading.ManualResetEvent($false)

# 处理控制台终止信号（比如Ctrl+C）
[Console]::CancelKeyPress += {
    $exitEvent.Set()
    $eventArgs.Cancel = $true
}

# 处理PowerShell宿主退出事件（NSSM停止服务时触发）
Register-ObjectEvent -InputObject $host -EventName "Exit" -Action {
    $global:exitEvent.Set()
} | Out-Null

# 保持脚本运行，直到收到终止信号
$exitEvent.WaitOne()

# 收到信号后清理所有Watcher
foreach ($watcher in $global:fileWatchers) {
    $watcher.EnableRaisingEvents = $false
    $watcher.Dispose()
}

同时检查NSSM配置：

• 确保服务的StopMethod设置为Terminate，保证能强制终止残留进程
• 可以在NSSM的AppExit配置中添加清理脚本，进一步确保进程被销毁

3. 规避FileSystemWatcher本身的重复触发特性 #

有时候多次触发并非实例残留，而是Watcher对文件操作的多阶段（如创建+修改）重复上报，需要加防抖逻辑：

# 记录最近处理的文件，过滤短时间内的重复事件
$processedFiles = @{}
$eventHandler = {
    $filePath = $Event.SourceEventArgs.FullPath
    $currentTime = Get-Date
    
    # 500ms内同一文件仅处理一次（可根据实际调整）
    if ($processedFiles.ContainsKey($filePath) -and ($currentTime - $processedFiles[$filePath]).TotalMilliseconds -lt 500) {
        return
    }
    $processedFiles[$filePath] = $currentTime

    # 执行文件移动逻辑...
}

# 绑定事件
Register-ObjectEvent -InputObject $newWatcher -EventName "Created" -Action $eventHandler | Out-Null

4. 验证进程与实例残留 #

用以下命令检查是否有旧PowerShell进程残留：

# 列出所有PowerShell进程
Get-CimInstance Win32_Process | Where-Object {$_.Name -match "powershell|pwsh"} | Select-Object ProcessId, CommandLine

# 若发现旧进程，手动终止验证
Stop-Process -Id 旧进程ID -Force

如果终止旧进程后重复触发消失，说明是NSSM未正确清理旧进程，需要调整服务配置。

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