UncheckedIOException是Java 8为在函数式接口中包装IOException而设的运行时异常，继承RuntimeException且保留原始异常链，用于Files.walk等流操作中绕过受检异常限制，需用try-catch捕获后构造而非裸throw。
UncheckedIOException 是 Java 8 引入的运行时异常，专为包装 IOException 设计，能在 Lambda 表达式或函数式接口（如 Function、Consumer）中绕过受检异常限制，从而让流式文件遍历（如 Files.walk()）保持简洁、函数式风格。
为什么需要 UncheckedIOException？
Java 的 Files.walk() 返回 Stream<path></path>，但其内部可能抛出 IOException（例如权限不足、路径不存在）。而 Stream 的中间/终端操作（如 map、forEach）接收的函数式接口不声明抛出受检异常。直接在 Lambda 中调用可能抛异常的方法会导致编译错误。
传统做法是捕获后转为运行时异常——UncheckedIOException 正是为此而生：它继承自 RuntimeException，且持有原始 IOException 实例，语义清晰、不丢失堆栈和原因。
正确包装 IOException 为 UncheckedIOException
不要在 Lambda 内部裸 throw 新建的 UncheckedIOException（会丢失原始异常上下文），而应显式捕获并重新抛出包装后的异常：
- 使用
try-catch捕获IOException，再构造UncheckedIOException(e) - 避免用
new UncheckedIOException("msg", e)手动传消息——除非有额外上下文，否则默认构造器已保留完整异常链 - 示例（安全读取每个文件大小）：
try (Stream<Path> stream = Files.walk(Paths.get("/data"))) {
stream
.filter(Files::isRegularFile)
.map(path -> {
try {
return Files.size(path); // 可能抛 IOException
} catch (IOException e) {
throw new UncheckedIOException(e); // ✅ 正确包装
}
})
.forEach(System.out::println);
} catch (UncheckedIOException e) {
// ✅ 统一捕获点，e.getCause() 即原始 IOException
System.err.println("I/O error: " + e.getCause().getMessage());
}
配合 Files.walk 的异常策略控制
Files.walk() 默认遇到 I/O 错误会立即终止流（抛出 IOException）。若希望跳过出错条目、继续遍历，需改用带 FileVisitOption 的重载，并配合自定义异常处理逻辑：
- 用
Files.walk(path, FileVisitOption.FOLLOW_LINKS)不改变默认行为 - 若需容错遍历，建议改用
Files.walkFileTree()+ 自定义SimpleFileVisitor，在visitFileFailed中返回FileVisitResult.CONTINUE，并在该方法中抛UncheckedIOException（供外层捕获） - 流式写法中无法直接控制 walk 的容错策略，因此对关键路径建议预校验（如
Files.exists()、Files.isReadable()）再进入流处理
统一异常处理与日志建议
由于 UncheckedIOException 是运行时异常，适合在顶层（如 try-with-resources 外层）集中捕获，而非每个 Lambda 内分散处理：
- 捕获后可通过
e.getCause()获取原始IOException，做针对性判断（如是否为AccessDeniedException） - 记录日志时推荐打印
e全量（含 cause），而非仅e.getMessage()，避免丢失根因 - 若需向调用方反馈具体失败路径，可在包装前将
path.toString()注入异常消息（谨慎使用，避免敏感路径泄露）
