C#处理跨设备链接错误方法

File.Move在Linux/macOS跨设备移动时抛出“cross-device link”错误，因其底层调用rename(2)系统调用失败；安全方案是捕获该异常后退化为File.Copy+File.Delete。

为什么 File.Move 在 Linux/macOS 上会抛出 "cross-device link" 错误

这是因为 File.Move 在 .NET 的底层实现中，对同一文件系统内的移动会调用 rename(2) 系统调用；但跨设备（比如从 /tmp 移动到 /home，或不同挂载点、不同磁盘）时，rename(2) 直接失败并返回 EXDEV 错误，.NET 就包装成 IOException 并附带 "cross-device link" 这个经典提示（源自 Unix 传统错误信息）。Windows 不受此限（NTFS 卷内移动本质是元数据更新），所以该问题主要出现在 Linux/macOS + .NET 6+（尤其是容器、WSL、CI 环境）。

如何安全地跨设备重命名/移动文件（兼容方案）

不能依赖 File.Move 的“原子性”假设——跨设备时它根本不会尝试复制+删除，而是直接失败。必须显式判断是否同设备，并在必要时退化为“复制+删除”流程。推荐做法：

• 用 File.Exists 和 Directory.GetParent 获取源/目标路径的根目录（如 /dev/sda1），再通过 statfs（Linux/macOS）或 GetVolumeInformation（Windows）比对设备 ID —— 但 .NET 没有跨平台 API 暴露这个
• 更实用：捕获 IOException，检查 ex.Message.Contains("cross-device") || ex.HResult == -2147024891（即 ERROR_NOT_SAME_DEVICE），然后手动执行 File.Copy(src, dst, true) + File.Delete(src)
• 注意：File.Copy 不保留所有元数据（如创建时间、扩展属性、ACL），若需精确还原，得额外调用 Process.Start("cp", "-a")（Linux/macOS）或 PowerShell 命令（Windows）

File.Move 和手动 copy+delete 的行为差异

关键区别不在功能，而在语义和副作用：

• File.Move 是原子操作（同设备）：要么全成功，要么不改变原文件；失败时原文件完好
• 手动 Copy + Delete 非原子：复制成功但删除失败 → 源文件残留 + 目标文件已存在（重复）；需加异常处理和清理逻辑
• 权限继承不同：File.Move 保持原文件权限；File.Copy 在 Linux/macOS 上默认使用进程 umask，可能丢失 group/other 权限
• 硬链接和符号链接：File.Move 移动的是链接本身；File.Copy 复制的是链接指向的内容（除非用 cp -d）

一个最小可用的跨设备移动辅助方法

以下代码不依赖外部工具，覆盖常见场景（含异常防护）：

public static bool MoveFileCrossDevice(string source, string destination)
{
    try
    {
        File.Move(source, destination);
        return true;
    }
    catch (IOException ex) when (IsCrossDeviceError(ex))
    {
        try
        {
            File.Copy(source, destination, true);
            File.Delete(source);
            return true;
        }
        catch (Exception copyEx)
        {
            // 可选：记录 copyEx，但不要吞掉 —— 复制失败比移动失败更严重
            throw new IOException($"Failed to copy then delete for cross-device move: {source} → {destination}", copyEx);
        }
    }
}

private static bool IsCrossDeviceError(IOException ex) =>
    ex.Message.Contains("cross-device", StringComparison.OrdinalIgnoreCase) ||
    ex.HResult == unchecked((int)0x80070011); // Windows ERROR_NOT_SAME_DEVICE

真正容易被忽略的是：目标路径所在文件系统是否满、是否有写权限、源文件是否被其他进程锁定——这些错误在 copy 阶段才暴露，而 File.Move 的失败早于它们。所以日志里看到 “cross-device” 并不意味问题根源只是设备不同。