@SneakyThrows是Lombok在编译期自动插入try-catch并将受检异常转为RuntimeException抛出的注解，适用于UTF-8编码、Thread.sleep、Class.forName等“理论上可能但实际不会发生”的场景，禁用于文件、网络、数据库等需差异化处理的异常。
用 Lombok 的 @SneakyThrows 注解，是简化受检异常处理最直接有效的方式。它不改变运行时行为，只在编译期悄悄补上 try-catch 并将受检异常转为运行时异常抛出，既绕过编译检查，又保留原始异常栈信息。
什么时候该用 @SneakyThrows
适合那些“理论上可能抛，实际上不会出问题”的场景：
- 字符编码操作：如
new String(bytes, "UTF-8")抛UnsupportedEncodingException—— JDK 强制支持 UTF-8，该异常逻辑上不可达 - 线程休眠：
Thread.sleep(100)抛InterruptedException—— 若当前线程不受外部中断影响，可视为安全忽略 - 反射调用：
Class.forName("xxx")抛ClassNotFoundException—— 类路径确定、启动时已校验，运行中不会动态缺失 - 工具类中固定格式的解析/序列化：如 JSON 转换用已知稳定的库，且输入结构受控
怎么正确加注解
关键在位置和粒度，错一处就无效：
- 加在具体方法上：
@SneakyThrows(IOException.class) public void readFile() { Files.readAllBytes(...); } - 支持多个异常：
@SneakyThrows({IOException.class, ParseException.class}) - Lambda 中必须作用于表达式本身：
list.forEach(@SneakyThrows item -> Files.readAllBytes(Paths.get(item)))，不能加在外层方法或 forEach 调用上 - 可提取为私有方法再引用：
private @SneakyThrows void load(String path) { ... }，然后list.forEach(this::load)
哪些情况坚决不用
不是所有受检异常都适合“偷偷抛”，掩盖真实风险反而更危险：
- 文件系统类异常：如
FileNotFoundException、AccessDeniedException—— 输入路径不确定，需差异化提示或降级 - 网络与数据库异常：如
SQLException、SocketTimeoutException—— 涉及重试、熔断、事务回滚等业务逻辑 - 公共 API 或框架回调方法：调用方依赖 throws 声明做契约理解，去掉后破坏接口语义
- 单元测试中故意触发异常验证流程：用
@Test(expected = ...)时，必须显式暴露异常类型
配合项目规范更安心
团队使用前建议配置 Lombok 全局约束，避免滥用：
- 在
lombok.config中启用警告：lombok.sneakyThrows.flagUsage = WARNING - 限制仅允许特定异常类型：
lombok.sneakyThrows.include = UnsupportedEncodingException, InterruptedException - 结合 Checkstyle 或 SonarQube 规则，扫描非工具类中对 IO/SQL 异常的 @SneakyThrows 使用
