Lombok 的 @SneakyThrows 注解具有 SOURCE 级保留策略，编译后即被擦除，无法通过反射直接检测；但可通过“异常抛出行为 + 方法签名检查”双重断言，间接、可靠地验证其存在与生效。
如何在单元测试中验证 lombok `@sneakythrows` 注解的实际效果：lombok 的 `@sneakythrows` 注解具有 `source` 级保留策略，编译后即被擦除，无法通过反射直接检测；但可通过“异常抛出行为 + 方法签名检查”双重断言，间接、可靠地验证其存在与生效。
Lombok 的 @SneakyThrows 是一个编译期增强注解，用于绕过 Java 的受检异常（checked exception）强制声明机制。它并非运行时可见的元数据——其 @Retention(RetentionPolicy.SOURCE) 决定了该注解仅存在于源码阶段，不会进入 .class 文件。因此，像 method.getAnnotation(SneakyThrows.class) 这类反射调用必然返回 null，IDEA 的提示 “Annotation is not retained for reflective access” 完全符合 JLS 规范，而非配置或环境问题。
既然无法“看见”注解，我们就转而验证它的行为效果：
✅ 方法能抛出受检异常（如 IOException），且无需在签名中 throws 声明；
✅ 调用该方法时，异常仍能正常向上抛出；
✅ 该方法的 getExceptionTypes() 返回空数组（证明签名未显式声明异常）。
以下是一个完整、可复用的单元测试范例（基于 JUnit 5）：
import org.junit.jupiter.api.Test;
import java.io.IOException;
import static org.junit.jupiter.api.Assertions.*;
import static org.junit.jupiter.api.Assertions.assertThrows;
class SneakyThrowsVerificationTest {
@Test
void myMethod_hasSneakyThrowsEffect() {
// 断言：调用方法时确实抛出了 IOException（行为验证）
IOException thrown = assertThrows(IOException.class, this::myMethod);
// 断言：方法签名中不包含 IOException（契约验证）
Class<?>[] declaredExceptions = getClass()
.getMethod("myMethod")
.getExceptionTypes();
assertFalse(
Arrays.asList(declaredExceptions).contains(IOException.class),
"Method signature must NOT declare IOException — @SneakyThrows should suppress it"
);
}
@SneakyThrows
public void myMethod() {
throw new IOException("Simulated checked exception");
}
}⚠️ 注意事项：
- 勿尝试反射读取 @SneakyThrows：任何 getAnnotation(SneakyThrows.class) 都会失败，这是设计使然，非 bug；
- 确保 Lombok 编译器插件已启用：Maven/Gradle 构建需配置 lombok 依赖，并在 IDE 中开启 annotation processing（如 IntelliJ 需勾选 Enable annotation processing）；
- 测试目标必须是编译后的字节码：确保测试运行在 target/classes（Maven）或 build/classes/java/test（Gradle）生成的类上，而非源码直读；
- 避免测试私有方法：若目标方法为 private，需先设为 package-private 或 protected，否则 getMethod() 无法访问（getDeclaredMethod() 仍不可行，因注解本身不存在）。
本质上，这是一种契约驱动测试（Contract-based Testing）：我们不关心“注解是否存在”，而关注“它承诺的行为是否达成”。这不仅更健壮（不受注解生命周期影响），也更贴近真实使用场景——开发者真正依赖的是 @SneakyThrows 带来的异常处理便利性，而非其元数据本身。
总结：验证 @SneakyThrows 的黄金法则 = assertThrows + getExceptionTypes().length == 0。两断言缺一不可，共同构成对注解语义的完整覆盖。
