UncheckedIOException 的核心作用是将受检的 IOException 转为运行时异常，使其合法用于 lambda 表达式；它不改变异常本质，保留 cause 和可追溯性，语义明确且为官方推荐包装方式。

UncheckedIOException 的核心作用，是把原本必须显式处理的 IOException（受检异常）转为运行时异常，从而合法地出现在 lambda 表达式中——它不是绕过错误，而是绕过编译器对“必须 try-catch”的强制要求。

为什么必须包装，而不是直接抛 IOException

Stream 的 map、filter、flatMap 等中间操作，其函数式接口（如 Function）的抽象方法签名不支持 throws IOException。直接在 lambda 里写 Files.readAllLines(...) 或 new FileInputStream(...)，编译器会报错：“Unhandled exception type IOException”。UncheckedIOException 继承自 RuntimeException，因此能被接受。

• 它不改变异常本质：底层 IO 错误照常发生，堆栈里仍保留原始 IOException
• 它保留可追溯性：e.getCause() 可安全强转为 IOException，便于日志记录或分类处理
• 它语义明确：比 new RuntimeException(e) 更准确，监控系统或 catch 块能识别这是 IO 问题

官方推荐的包装方式：手动 try-catch + UncheckedIOException 构造

Java 标准库没有提供自动包装工具类，因此最稳妥、最透明的做法是在 lambda 内部做一层轻量 try-catch，并用 new UncheckedIOException(e) 显式包装：

Upload audio to AIOZ Stream

快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象，上传文件并完成处理后返回音频链接。

下载

• 不要写 throw new RuntimeException(e) —— 丢失类型信息，instanceof UncheckedIOException 判断失效
• 不要传入非 IOException 类型（如 SQLException），否则构造器会抛 IllegalArgumentException
• 典型写法示例：

  lines.map(line -> {
    try {
      return parseJsonLine(line); // 可能抛 IOException
    } catch (IOException e) {
      throw new UncheckedIOException(e);
    }
  })

更简洁的实践：封装成工具方法

重复写 try-catch 降低可读性。推荐提取为静态工具方法，例如：

• readStringSafely(Path p)：内部调用 Files.readString(p)，捕获 IOException 后包装并重抛
• parseAsIntSafely(String s)：虽不涉及 IO，但同理可用于其他受检逻辑，统一风格
• 好处：业务 lambda 保持干净，异常处理逻辑集中，便于统一加日志或熔断策略

必须同步关注的配套责任

UncheckedIOException 解决了“能不能抛”的问题，但不减免资源管理责任：

• Files.lines() 返回的 Stream 必须用 try-with-resources 包裹，否则文件句柄泄漏
• 不要因用了 UncheckedIOException 就省略 Files.exists() 或权限预检——它不预防错误，只改变传播方式
• Web 接口或关键服务中，不建议直接向上冒泡；应在流终止前 catch UncheckedIOException，转为友好的响应或降级逻辑