FileHandle导致File.Move操作失败的原因排查

问题现象 #

使用FileStream打开文件后，**复制粘贴（File.Copy带覆盖参数）可以正常执行，但剪切粘贴（File.Move带覆盖参数）**会触发访问拒绝错误，仅在目标文件被FileStream持有句柄时出现。

核心代码片段 #

打开文件的代码：

var fs = new FileStream(
    File.OpenHandle(
        path,
        mode: FileMode.Open,
        access: FileAccess.Read,
        share: FileShare.Delete | FileShare.ReadWrite
        ), FileAccess.Read);

复现错误的完整代码：

var path = @"C:\temp\test\test.log";
var pathCopy = @"C:\temp\test.log";

var fs = new FileStream(
    File.OpenHandle(
        path,
        mode: FileMode.Open,
        access: FileAccess.Read,
        share: FileShare.Delete | FileShare.ReadWrite
        ), FileAccess.Read);
    

File.Copy(pathCopy, path, true); // 正常执行
File.Move(pathCopy, path, true); // 执行失败 -> 访问拒绝错误

原因分析 #

Windows文件系统的底层行为差异导致了这个现象：

1. File.Copy(..., true)的逻辑：直接打开目标文件进行写入（因为FileShare.ReadWrite允许写入访问），本质是修改目标文件的内容，不需要替换文件的目录条目，因此可以绕过句柄持有限制。
2. File.Move(..., true)的逻辑：底层调用MoveFileEx API并传入MOVEFILE_REPLACE_EXISTING标志，需要直接替换目标文件的目录条目。即使设置了FileShare.Delete，只要目标文件有打开的句柄，系统就不允许替换目录条目——因为FileShare.Delete仅允许标记文件为“待删除”，直到所有句柄关闭后才会真正删除，无法在句柄持有期间完成目录项替换。

解决方案 #

根据业务场景选择以下方案：

• 方案1：临时关闭句柄（推荐）
  在执行File.Move前关闭目标文件的FileStream，完成移动后重新打开：

  var path = @"C:\temp\test\test.log";
  var pathCopy = @"C:\temp\test.log";
  
  using (var fs = new FileStream(
      File.OpenHandle(
          path,
          mode: FileMode.Open,
          access: FileAccess.Read,
          share: FileShare.Delete | FileShare.ReadWrite
          ), FileAccess.Read))
  {
      // 读取文件逻辑
  }
  
  // 关闭句柄后执行Move
  File.Move(pathCopy, path, true);
  
  // 重新打开文件继续操作
  var fsNew = new FileStream(
      File.OpenHandle(
          path,
          mode: FileMode.Open,
          access: FileAccess.Read,
          share: FileShare.Delete | FileShare.ReadWrite
          ), FileAccess.Read);
  

• 方案2：模拟Move操作（非原子）
  先复制文件再删除源文件，替代File.Move的覆盖逻辑，但此操作不是原子性的，若中途出错会导致文件冗余：

  File.Copy(pathCopy, path, true);
  File.Delete(pathCopy);
  

• 方案3：先删除目标再移动
  利用FileShare.Delete权限先删除目标文件，再执行不带覆盖参数的File.Move，但原FileStream的句柄会指向已删除的“孤儿文件”，需注意后续操作：

  File.Delete(path);
  File.Move(pathCopy, path);
  

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