不能直接 flatMap(Files.list) 实现递归，因为 Files.list 仅返回单层子项，对文件调用会抛 NotDirectoryException，权限不足或符号链接循环也会出错，且需手动关闭 Stream 防资源泄漏。
Java Stream API 本身不直接支持递归遍历目录，flatMap 可以配合 Files.list 实现递归，但需手动处理子目录——因为 Files.list 只返回一级内容，不递归，也不自动跳过符号链接或权限异常。真正安全、简洁的做法是用 Files.walk；若坚持用 flatMap + Files.list，必须自己写递归逻辑并妥善处理异常和边界。
为什么不能直接 flatMap(Files.list) 就递归？
Files.list(Path) 返回的是单层 Stream
- 子项是文件（非目录）→ 调用 Files.list 抛出 NotDirectoryException
- 子项是目录但无读取权限 → 抛出 AccessDeniedException
- 存在循环符号链接 → 可能无限递归或抛出 FileSystemLoopException
- 未关闭 Stream → 资源泄漏（Files.list 返回的 Stream 需显式 try-with-resources 或 close）
用 flatMap + Files.list 手动实现递归（带异常防护）
核心思路：对每个 Path，先判断是否为目录且可访问，再 list；用 flatMap 展开子项，对子目录继续递归（通过方法引用或 Supplier）。注意必须捕获 IOException 并跳过异常路径，否则整个 Stream 中断。
示例代码（返回所有普通文件路径）：
立即学习“Java免费学习笔记（深入）”；
public static Stream<Path> listAllFiles(Path root) {
try {
return Files.list(root)
.flatMap(path -> {
if (Files.isDirectory(path) && !Files.isSymbolicLink(path)) {
try {
return listAllFiles(path); // 递归
} catch (IOException e) {
return Stream.empty(); // 权限不足等，静默跳过
}
} else if (Files.isRegularFile(path)) {
return Stream.of(path);
} else {
return Stream.empty();
}
});
} catch (IOException e) {
return Stream.empty();
}
}
⚠️ 注意：该方法仍可能因深层嵌套导致栈溢出（深度递归），且未处理符号链接循环——生产环境不推荐。
更可靠替代方案：用 Files.walk（推荐）
Files.walk(root) 是专为递归设计的标准 API，底层已处理异常、符号链接、权限等问题，并支持限制深度、跳过异常：
- Files.walk(root).filter(Files::isRegularFile) → 获取所有文件
- Files.walk(root, 3) → 最多遍历 3 层
- Files.walk(root).onClose(() -> System.out.println("done")) → 可注册清理逻辑
- 默认会跳过无法访问的路径（除非显式配置 FileVisitOption.FOLLOW_LINKS）
它返回的 Stream
如果必须用 flatMap + Files.list，至少加这三道防护
- 用 Files.exists(path, LinkOption.NOFOLLOW_LINKS) 和 Files.isDirectory(path, LinkOption.NOFOLLOW_LINKS) 避免符号链接陷阱
- 所有 Files.list() 必须包裹在 try-catch 中，捕获 IOException 子类（如 AccessDeniedException），返回 empty Stream
- 用 Stream.concat(Stream.of(file), recursiveStream) 替代纯 flatMap，更易控制流程（但性能略低）
