C#用ClosedXML保存Excel至网络驱动器提示文件被占用问题

问题原因 #

1. 网络文件系统IO延迟：本地磁盘的文件操作几乎即时完成，但网络驱动器需要通过网络传输数据、更新文件元数据，文件锁释放、状态同步存在延迟。ClosedXML完成保存后，网络文件系统可能还没完全处理完文件状态更新，后续操作就触发了“文件被占用”的检测。
2. 资源未及时释放：代码中未显式释放XLWorkbook资源，本地环境下GC和文件系统能快速回收句柄，但网络环境下资源回收延迟会导致文件句柄未完全释放，被系统判定为“被占用”。
3. 网络存储锁定/缓存机制：部分网络存储（如SMB共享）的文件锁定策略更严格，或自带缓存机制导致文件状态更新不及时，即使无其他进程使用，系统也会误判文件被占用。

可行解决办法 #

1. 显式释放Workbook资源 #

用using语句包裹XLWorkbook，确保文件句柄操作完成后立即释放，避免资源泄漏：

var path = @"E:\CCI_Reporting";
for (var i = 1; i < 100; i++)
    try
    {
        using (var workBook = new XLWorkbook($@"{path}\0.xlsx"))
        {
            workBook.SaveAs($@"{path}\{i}.xlsx");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }

2. 增加重试机制+短延迟 #

针对网络延迟问题，捕获“文件被占用”错误时重试几次，每次重试前加短延迟，给网络文件系统足够同步时间：

var path = @"E:\CCI_Reporting";
const int maxRetries = 3;
const int retryDelayMs = 500;

for (var i = 1; i < 100; i++)
{
    bool savedSuccessfully = false;
    int retryAttempts = 0;

    while (!savedSuccessfully && retryAttempts < maxRetries)
    {
        try
        {
            using (var workBook = new XLWorkbook($@"{path}\0.xlsx"))
            {
                workBook.SaveAs($@"{path}\{i}.xlsx");
            }
            savedSuccessfully = true;
        }
        catch (IOException ex) when (ex.Message.Contains("正被另一个进程使用"))
        {
            retryAttempts++;
            Thread.Sleep(retryDelayMs);
            if (retryAttempts == maxRetries)
            {
                Console.WriteLine($"文件{i}.xlsx 尝试{maxRetries}次保存失败：{ex.Message}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"文件{i}.xlsx 保存出错：{ex.Message}");
            break;
        }
    }
}

3. 使用UNC路径替代映射驱动器 #

映射驱动器（如E:\）可能存在额外连接缓存或兼容性问题，直接用UNC路径（比如\\服务器地址\共享目录\CCI_Reporting）可减少中间层干扰，提升文件操作稳定性。

4. 调整网络存储配置 #

若有权限，检查网络存储的SMB版本（优先用SMB3），调整文件锁定超时时间或关闭不必要的文件缓存策略，部分存储设备可优化文件操作同步逻辑，减少误判概率。

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