Java文件备份工具实现与IO操作详解

最稳妥的小文件备份应使用Files.copy()而非手动流操作，需指定REPLACE_EXISTING和COPY_ATTRIBUTES选项，用Files.createDirectories()建目录，通过Files.getLastModifiedTime()比较时间戳判断是否需备份，失败时保留原备份并记录带上下文的日志。

用 Files.copy() 做基础文件复制最稳妥

小文件备份的核心就是可靠复制，别自己手写 InputStream/OutputStream 循环——容易漏关流、没处理中断、忽略异常恢复。Java 7+ 的 Files.copy() 内置原子性检查和资源自动管理，出错时不会留下半截文件。

• 必须指定 StandardCopyOption.REPLACE_EXISTING，否则目标存在时直接抛 FileAlreadyExistsException
• 避免用 Path.toFile().mkdirs() 手动建目录，改用 Files.createDirectories(path.getParent())，它能正确处理并发创建和权限问题
• 如果源文件可能被其他进程写入，加 StandardCopyOption.COPY_ATTRIBUTES 可保留最后修改时间（但 Windows 上不保证生效）

Path src = Paths.get("data/report.txt");
Path dst = Paths.get("backup/report_20240520.txt");
Files.createDirectories(dst.getParent());
Files.copy(src, dst, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.COPY_ATTRIBUTES);

判断文件是否真的需要备份：用 Files.getLastModifiedTime() 比大小

频繁全量备份浪费 I/O，得跳过未改动的文件。不能只比文件名或长度——同名不同内容、同大小不同内容都常见。最轻量且可靠的方式是比最后修改时间戳。

• Files.getLastModifiedTime(src) 和 Files.getLastModifiedTime(dst) 返回 FileTime，直接用 .compareTo() 判断大小
• 注意：NFS 或某些 Docker 卷可能返回精度为秒的时间戳，此时需用 toMillis() 转毫秒再比较，避免误判
• 不要用 lastModified()（File 类方法），它在 Java 8+ 中已不推荐，且无法处理符号链接真实时间

备份失败时保留原备份并记录错误：用 try-with-resources + Throwable.addSuppressed()

备份过程中可能因磁盘满、权限不足、路径含非法字符等失败。此时若强行删除已有备份，就真丢数据了。安全做法是：失败时不碰旧备份，把错误信息追加到日志文件。

• 用 try-with-resources 包裹 Files.newBufferedWriter() 写日志，确保句柄释放
• 捕获 IOException 后，调用 e.addSuppressed(new RuntimeException("backup to " + dst)) 把上下文带上，方便排查
• 日志路径建议固定，比如 backup.log 放在备份根目录下，别用相对路径拼接，防止工作目录变更导致写入失败

Windows 下路径含中文或空格？统一用 Paths.get() 构造 Path

手动拼接字符串（如 "D:\\backup\\my file.txt"）在 Windows 上极易因转义、编码、UNC 路径等问题失败。Java 的 Path 类内部已处理好所有平台差异。

• 永远用 Paths.get("D:", "backup", "用户报告.xlsx")，不用 new File("D:\\backup\\用户报告.xlsx")
• 如果路径来自用户输入（如命令行参数），先用 URLDecoder.decode(arg, "UTF-8") 解码，再传给 Paths.get()
• 遇到 InvalidPathException，大概率是字符串里混入了控制字符（比如剪贴板带不可见符），加一行 arg = arg.replaceAll("\\p{Cntrl}", "") 过滤掉

备份逻辑本身不复杂，真正卡住人的往往是路径解析失败、时间戳精度误判、异常后旧备份被清空这三类问题。写的时候多打两行日志，比事后翻堆栈强得多。