ProGuard 默认会移除字节码中的 Exceptions 属性，导致 Java 客户端无法感知 Kotlin 方法声明的受检异常（如 @Throws(MyCustomException::class)），从而编译报错。解决方法是显式保留 Exceptions 属性，而非仅保留注解本身。
proguard 默认会移除字节码中的 `exceptions` 属性，导致 java 客户端无法感知 kotlin 方法声明的受检异常（如 `@throws(mycustomexception::class)`），从而编译报错。解决方法是显式保留 `exceptions` 属性，而非仅保留注解本身。
在 Kotlin 中，@Throws 是一个编译期注解（@Target(AnnotationTarget.FUNCTION)），其核心作用并非仅向 IDE 提供提示，而是通过生成 JVM 字节码中的 Exceptions 属性（即 Code 属性中的 exception_table 和 Signature 相关元数据），让 Java 编译器（javac）能正确执行受检异常检查（checked exception checking）。
值得注意的是：Kotlin 本身不强制要求调用方处理受检异常（因其运行时模型与 Java 不同），但当 Kotlin 库被 Java 代码调用时，JVM 规范要求 Java 编译器依据字节码中声明的 Exceptions 属性进行语法校验。若该属性被 ProGuard 移除，Java 客户端的 catch (MyCustomException e) 就会因“该异常未在方法签名中声明”而编译失败，即使 Kotlin 源码中已明确标注 @Throws。
关键误区在于：许多开发者尝试使用 -keepattributes *Annotation* 或 -keep class kotlin.**，但这无法解决问题——因为 @Throws 在编译后不会以运行时注解形式存在，而是被 Kotlin 编译器（kotlinc）转化为标准 JVM Exceptions 属性写入字节码。因此，ProGuard 需要保留的是该字节码属性，而非注解类本身。
✅ 正确解决方案：在 ProGuard 配置文件（如 proguard-rules.pro）中添加以下规则：
-keepattributes Exceptions
该规则指示 ProGuard 保留所有方法的 Exceptions 属性，确保 doSomething() 方法在混淆/优化后的字节码中仍明确声明抛出 MyCustomException，从而使 Java 调用方能通过编译。
⚠️ 注意事项：
- -keepattributes Exceptions 是 JVM 标准属性名，区分大小写，不可写作 exceptions 或 exception；
- 无需额外保留 @Throws 注解类（如 kotlin.Throws），因其在运行时不可见，且不影响 Java 编译逻辑；
- 若库中还包含其他需被 Java 消费的 Kotlin 异常声明（如 @Throws(IOException::class, SecurityException::class)），此规则同样生效；
- 建议将该规则置于库模块的 ProGuard 配置中（而非客户端），以保障发布 AAR/JAR 的 ABI 兼容性；
- 使用 R8（Android Gradle Plugin 3.4+ 默认）时，该规则同样有效，R8 完全兼容 ProGuard 属性保留语法。
? 补充验证方式：
可使用 javap -v YourKotlinClass.class | grep -A 5 "Exceptions" 检查混淆前/后字节码中是否存在 Exceptions: 行。添加 -keepattributes Exceptions 后，输出应包含类似：
Exceptions: throws com.yourpackage.MyCustomException
总结：解决 Kotlin 库被 Java 调用时 @Throws “失效”的根本，在于理解其底层机制——它依赖 JVM 字节码属性而非注解反射。通过 -keepattributes Exceptions 精准保留该属性，即可无缝支持跨语言异常契约，确保 API 的健壮性与互操作性。
