独立线程FileSystemWatcher在Windows Server 2016上报错求助

首先得明确：本地正常但Windows Server 2016上报错，大概率是环境权限、文件系统行为差异或者线程安全问题导致的。咱们一步步来拆解：

第一步：先拿到明确的报错信息 #

你现在只知道报错，但没具体日志，这是排查的核心障碍。给关键方法加上异常捕获，把错误信息写入本地日志文件：

private void OnCreate(object source, FileSystemEventArgs e) {
    try {
        string fileExtension = Path.GetExtension(e.FullPath);
        if (extensionWatch.Contains(fileExtension)) {
            SaveFileData(fileExtension, e.FullPath);
        }
    } catch (Exception ex) {
        // 把日志写到服务器上可访问的路径
        File.AppendAllText(@"C:\script_debug.log", 
            $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] OnCreate异常：{ex.Message}\n堆栈：{ex.StackTrace}\n\n");
    }
}

// 同样给PushFiles、SaveFileData等方法加上try-catch
private void PushFiles(string destinationPath, int timeAbandon, BackgroundWorker worker) {
    try {
        // 原方法逻辑
    } catch (Exception ex) {
        File.AppendAllText(@"C:\script_debug.log", 
            $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] PushFiles异常：{ex.Message}\n堆栈：{ex.StackTrace}\n\n");
    }
}

运行脚本后查看日志，就能知道具体是权限问题、文件访问问题还是逻辑错误。

针对Windows Server环境的常见坑点 #

1. 文件权限不足 #

Windows Server的UAC和权限管控比本地严格得多：

• 确认脚本运行的账户（比如你登录的账户、或者服务账户）有监控目录、推送目录、日志目录的读写删除权限；
• 右键目标目录→属性→安全→检查对应账户的权限，必要时临时添加「完全控制」权限测试（测试通过后再缩小权限范围）；
• 如果脚本是作为Windows服务运行，一定要给服务账户配置足够的目录权限（别用LocalSystem，推荐创建专门的服务账户）。

2. FileSystemWatcher触发时机过早 #

服务器上的文件写入速度可能比本地慢，当Created事件触发时，文件可能还在被写入（处于锁定状态），导致后续操作报错。给OnCreate加一个「等待文件可访问」的逻辑：

private bool WaitForFileReady(string filePath, int maxRetries = 15) {
    int retry = 0;
    while (retry < maxRetries) {
        try {
            // 尝试以独占方式打开文件，验证是否可访问
            using (var stream = File.Open(filePath, FileMode.Open, FileAccess.ReadWrite, FileShare.None)) {
                return true;
            }
        } catch (IOException) {
            retry++;
            Thread.Sleep(500); // 等待500ms后重试
        }
    }
    return false;
}

// 在SaveFileData前调用
private void OnCreate(object source, FileSystemEventArgs e) {
    try {
        string fileExtension = Path.GetExtension(e.FullPath);
        if (extensionWatch.Contains(fileExtension)) {
            if (WaitForFileReady(e.FullPath)) {
                SaveFileData(fileExtension, e.FullPath);
            } else {
                File.AppendAllText(@"C:\script_debug.log", $"[{DateTime.Now}] 文件{e.FullPath}长时间无法访问，跳过处理\n");
            }
        }
    } catch (Exception ex) {
        // 日志逻辑
    }
}

3. 线程安全问题 #

你的fileCollect被多个线程同时访问（FileSystemWatcher的事件线程修改，主线程读取CheckIfDone），可能出现线程竞争导致的逻辑错误：

// 加一个全局锁对象
private readonly object _fileCollectLock = new object();

// 修改CheckIfDone，加锁读取
private bool CheckIfDone(int stackId) {
    lock (_fileCollectLock) {
        return fileCollect[stackId].All(file => file["finished"] == "true");
    }
}

// 修改file["finished"]的地方也要加锁
private void SaveFileData(string fileExtension, string fullPath) {
    lock (_fileCollectLock) {
        // 你的原逻辑：找到对应文件，设置finished为true
    }
}

另外，endWatcher变量要加volatile修饰，确保线程间的可见性：

private volatile bool endWatcher = false;

代码逻辑优化建议 #

• 把Thread.Sleep(1000)换成await Task.Delay(1000)（如果方法允许异步），避免阻塞线程；
• CheckIfDone里可以用All方法简化逻辑，比循环判断更简洁；
• 发布.NET Core应用时，选择「独立部署」模式（不需要服务器安装.NET Core runtime），避免依赖问题。

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