FileAlreadyExistsException在Java中由NIO.2 API的文件创建操作触发，如Files.createFile()时目标已存在。可通过预检查、异常捕获或StandardOpenOption控制行为，结合自动重命名等策略避免覆盖，提升程序健壮性。
在Java中进行文件操作时，FileAlreadyExistsException 是一个常见的异常，通常出现在尝试创建已存在的文件或目录时。为了避免意外覆盖已有文件，同时优雅地处理该异常，开发者可以结合NIO.2 API和合理的逻辑判断来实现安全的文件写入。
理解 FileAlreadyExistsException 的触发场景
这个异常属于 java.nio.file 包，主要由以下操作引发：
- 使用 Files.createFile(path) 创建文件时，目标路径已存在
- 调用 Files.createDirectory() 或 Files.createDirectories() 且目录已存在
- 执行原子性移动（move）操作并启用 REPLACE_EXISTING 以外的选项
它不是简单的警告，而是明确提示“你试图创建一个已经存在的资源”，从而防止数据被静默覆盖。
使用 NIO.2 正确处理文件创建冲突
推荐使用 java.nio.file.Files 类配合 StandardOpenOption 进行细粒度控制。以下是几种典型策略：
立即学习“Java免费学习笔记（深入）”；
1. 显式检查文件是否存在
在创建前先判断，避免异常抛出：
Path path = Paths.get("data.txt");
if (!Files.exists(path)) {
Files.createFile(path);
} else {
System.out.println("文件已存在，跳过创建");
}
2. 捕获异常并处理
允许尝试创建，并通过 try-catch 响应冲突：
try {
Files.createFile(path);
System.out.println("文件创建成功");
} catch (FileAlreadyExistsException e) {
System.err.println("文件已存在：" + e.getFile());
} catch (IOException e) {
System.err.println("其他I/O错误：" + e.getMessage());
}
3. 使用 OpenOptions 控制写入行为
利用 Files.newOutputStream() 结合打开选项，灵活决定行为：
- StandardOpenOption.CREATE_NEW：仅当文件不存在时创建，否则抛出异常
- StandardOpenOption.CREATE：若存在则打开，不存在则创建（不报错）
- StandardOpenOption.APPEND：追加模式写入，保留原内容
示例：确保不覆盖的写入方式
try (OutputStream out = Files.newOutputStream(
path,
StandardOpenOption.CREATE_NEW)) {
out.write("Hello".getBytes());
}
提供用户友好的替代方案
实际应用中，可设计自动重命名机制来避免中断流程：
public Path createUniqueFile(Path base) throws IOException {
Path target = base;
int counter = 1;
while (Files.exists(target)) {
target = base.getParent().resolve(
base.getFileName() + "." + (counter++)
);
}
return Files.createFile(target);
}
这样即使原始文件存在，也能生成如 data.txt.1、data.txt.2 等递增名称的新文件。
基本上就这些。关键是根据业务需求选择“预防”、“捕获”还是“绕开”策略，合理运用 NIO.2 提供的工具，既能避免数据丢失，又能提升程序健壮性。
