Java Files.copy() 方法详解：高效文件与流复制的最佳实践
在 Java 编程中，实现文件或数据流的复制是常见需求。Files.copy() 方法作为 Java NIO.2 文件操作的核心 API，以其简洁高效著称，成为开发者的首选工具。然而，要充分发挥其威力，必须理解其特性与潜在“陷阱”。默认情况下，它不会覆盖已存在文件，需要显式指定 StandardCopyOption.REPLACE_EXISTING；复制输入流时，必须妥善管理资源；处理大文件时需关注性能与完整性；保留文件属性则受限于文件系统与选项。本文将深入解析这些关键点，助你掌握 Java 文件复制的精髓。
解决 Files.copy() 抛出 FileAlreadyExistsException 异常
当 Files.copy() 操作因目标文件已存在而失败时，抛出 FileAlreadyExistsException 是正常行为，这体现了其防止数据意外覆盖的安全设计哲学。
解决方案非常明确：在调用方法时，主动传入 StandardCopyOption.REPLACE_EXISTING 选项，以声明覆盖意图。
Files.copy(sourcePath, targetPath, StandardCopyOption.REPLACE_EXISTING);
- 若省略此选项，无论目标文件内容如何，都会触发此异常。
- 重要细节：如果目标路径指向一个已存在的目录，即使使用
REPLACE_EXISTING，依然会抛出异常，因为目录无法被直接覆盖，通常需要先删除。 - 在 Windows 系统中，若目标文件被其他进程锁定，即使指定覆盖选项，也可能引发
AccessDeniedException。采用“创建临时文件后原子性重命名”的策略是更稳健的替代方案。
Files.copy() 复制 InputStream 到文件内容为空的原因与修复
使用 Files.copy(InputStream, Path) 重载方法时，内容为空或缺失是常见问题。根源通常在于输入流管理不当：未正确关闭、已被部分读取，或遗漏了覆盖选项。
关键在于确保传入的 InputStream 处于可读的初始状态，并妥善管理其生命周期：
try (InputStream is = new FileInputStream(sourceFile)) {
Files.copy(is, targetPath, StandardCopyOption.REPLACE_EXISTING);
}
- 强制使用
try-with-resources语句自动管理流资源，这是避免资源泄漏和后续操作失败的最佳实践。 - 切勿传入已执行过
read()或skip()操作的流，因为Files.copy()不会重置流的读取位置。 - 从实现机制看，此方法底层利用
Channels.newChannel()和transferTo()，在支持的操作系统上可实现高效的零拷贝传输。但对于ByteArrayInputStream等内存流，则会退化为常规的字节循环复制。
复制大文件时性能卡顿或内存异常分析
复制大文件时出现卡顿或内存消耗过高，并非 Files.copy() 本身存在缺陷，而是其底层实现与特定系统环境交互的结果。该方法依赖 FileChannel.transferTo 等通道技术，本身不分配大缓冲区。然而，某些 Linux 内核版本对单次 transferTo 调用有大小限制（如 2GB），超大文件复制会被拆分。若中间步骤失败（如磁盘空间不足），可能导致操作静默中断，目标文件被截断。
- 必须检查返回值：
Files.copy()返回实际复制的字节数。务必将其与源文件大小对比，数值不符即表明复制过程不完整。 - 在 NFS、CIFS 等网络文件系统上，零拷贝特性可能失效，系统会降级为缓冲复制，导致性能下降。
- 对于数 GB 以上的超大文件，建议采用手动缓冲复制策略（例如使用 8KB 的
byte[]数组循环读写）。虽然代码量增加，但便于集成进度监控、中断控制，提升了操作的可靠性与可观测性。
如何使用 Files.copy() 保留文件权限与时间戳属性
Files.copy() 能够保留文件属性，但功能存在限制，主要适用于同一文件系统内的普通文件复制，且需要明确指定相应选项。
要保留文件的最后修改时间，需使用 StandardCopyOption.COPY_ATTRIBUTES 选项。若要完整保留权限、所有者及 ACL 等信息，则需要结合 PosixFilePermissions 或 FileOwnerAttributeView 等 API 进行额外处理。需注意，跨文件系统复制或在 Windows 平台上，许多属性可能无法完全保留。
Files.copy(sourcePath, targetPath,
StandardCopyOption.REPLACE_EXISTING,
StandardCopyOption.COPY_ATTRIBUTES);
- 在 Linux/Unix 系统上，
COPY_ATTRIBUTES通常可保留修改时间（mtime）和访问时间（atime），但状态变更时间（ctime）会被更新为复制时间。 - 在 Windows 系统上，此选项可能保留“最后写入时间”，但对于 NTFS 权限（ACL）无效。如需保留权限，需额外调用
Files.setPosixFilePermissions()或使用AclFileAttributeView。 - 核心限制：当复制源为
InputStream（而非Path）时，COPY_ATTRIBUTES选项完全无效，因为流对象不包含任何文件系统元数据。
总结而言，Files.copy() 是一个强大但非全能的工具。其语义和功能深度依赖于 Path 对象和底层文件系统的支持能力。在面对复杂场景，如网络存储、容器卷、FUSE 文件系统或特殊权限模型时，最可靠的方案往往是回归手动控制数据流，亲自处理异常边界并确保操作的原子性，从而获得最高的可控性。
