java.nio.Files.move移动文件到NAS报AtomicMoveNotSupportedException怎么解决

StandardCopyOption.ATOMIC_MOVE 是操作系统层面的原子移动操作，仅支持同一个文件系统/挂载点内的文件移动。你当前的源路径是本地磁盘挂载点，目标路径是NAS共享挂载点，属于跨设备操作，操作系统本身不支持跨设备原子移动，因此抛出AtomicMoveNotSupportedException以及Invalid cross-device link错误。

下面的方案均可以实现跨设备文件转移，同时尽可能保证操作的原子性避免产生无效文件：

• 方案1：Java原生API实现「先复制到临时文件、再改名、最后删源文件」
  该方案不需要依赖第三方工具，通过临时文件兜底避免目标目录出现半截可访问的文件，示例代码如下：

  import java.nio.file.*;
  import java.io.IOException;
  
  public class CrossDeviceMove {
      public void crossDeviceMove(Path source, Path finalTarget) throws IOException {
          // 生成目标目录下的临时文件路径，避免复制中断产生无效的目标文件
          Path tempTarget = finalTarget.resolveSibling(finalTarget.getFileName().toString() + ".tmp");
          try {
              // 复制源文件到临时路径，允许覆盖已存在的临时文件
              Files.copy(source, tempTarget, StandardCopyOption.REPLACE_EXISTING);
              // 同目录下改名，NAS同挂载点内的改名操作支持原子移动
              Files.move(tempTarget, finalTarget, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.ATOMIC_MOVE);
              // 校验文件大小一致后删除源文件，可根据需求替换为MD5/CRC校验
              if (Files.size(source) == Files.size(finalTarget)) {
                  Files.delete(source);
              } else {
                  throw new IOException("文件复制不完整，源文件与目标文件大小不一致");
              }
          } catch (Exception e) {
              // 异常场景清理临时文件
              Files.deleteIfExists(tempTarget);
              throw e;
          }
      }
  
      public static void main(String[] args) throws IOException {
          Path path1 = Paths.get("/localdir/tempfile.zip_2021-11-12-12_19_27_0327");
          Path path2 = Paths.get("/sharednas/finish/tempfile.zip_2021-11-12-12_19_27_0327");
          new CrossDeviceMove().crossDeviceMove(path1, path2);
      }
  }
  

• 方案2：调整临时文件生成路径
  直接把业务过程中的临时文件生成目录改到NAS的专属临时目录，后续从NAS临时目录移动到/sharednas/finish/属于同挂载点操作，可以直接用原来的ATOMIC_MOVE逻辑，性能远高于跨设备复制。
• 方案3：调用系统命令rsync实现
  大文件场景推荐用该方案，rsync自带断点续传、完整性校验、增量同步能力，还支持复制完成自动删除源文件，示例代码如下：

  public void rsyncMove(Path source, Path finalTarget) throws IOException, InterruptedException {
      ProcessBuilder pb = new ProcessBuilder(
              "rsync",
              "-a", // 归档模式，保留文件属性
              "--remove-source-files", // 传输完成后删除源文件
              source.toString(),
              finalTarget.toString()
      );
      // 合并标准输出和错误流，方便排查问题
      pb.redirectErrorStream(true);
      Process process = pb.start();
      int exitCode = process.waitFor();
      if (exitCode != 0) {
          // 可读取process.getInputStream()获取错误详情
          throw new IOException("rsync执行失败，退出码：" + exitCode);
      }
  }
  

• 跨NAS传输场景建议添加重试机制，应对网络波动导致的传输失败
• 对文件完整性要求高的业务场景，建议在传输完成后做MD5或者CRC校验，避免静默数据损坏
• 调用系统命令的场景不要直接拼接用户可控的参数，避免命令注入风险

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