Retrofit 1.x中Proguard混淆自定义注解问题求助

遇到这种自定义Retrofit注解被Proguard搞崩的情况太常见了——毕竟Retrofit 1.x完全依赖反射来解析接口方法上的注解信息，而Proguard默认会混淆甚至移除它认为“无用”的注解类和相关元数据，直接导致Retrofit找不到请求的配置规则。

下面是几个经过验证的解决办法，按优先级来：

1. 添加针对性的Proguard规则（最核心） #

你需要明确告诉Proguard保留你的自定义注解、它的元注解，以及接口中使用该注解的方法的注解信息。在你的proguard-rules.pro文件中添加以下规则：

# 保留自定义的DELETE_WITH_A_BODY注解及其所有属性方法
-keep @interface com.example.android.MyRetrofitService$DELETE_WITH_A_BODY {
    *;
}

# 确保接口中使用该自定义注解的方法，其注解信息不被移除或混淆
-keepclassmembers interface com.example.android.MyRetrofitService {
    @com.example.android.MyRetrofitService$DELETE_WITH_A_BODY <methods>;
}

# 保留Retrofit核心的RestMethod注解，避免它被混淆
-keep @interface retrofit.http.RestMethod {
    *;
}

# Retrofit 1.x基础必备的混淆规则，确保框架能正常解析注解
-keep class retrofit.** { *; }
-keepattributes Signature,RuntimeVisibleAnnotations,AnnotationDefault
-keepclassmembers,allowobfuscation interface * {
    @retrofit.http.* <methods>;
}

关键规则说明： #

• RuntimeVisibleAnnotations：强制Proguard保留运行时可见的注解，这是Retrofit反射读取注解的基础；
• MyRetrofitService$DELETE_WITH_A_BODY：因为你的自定义注解是接口的内部类，必须用$符号来引用，否则Proguard找不到这个类；
• <methods>：匹配接口中所有使用该注解的方法，确保它们的注解实例不被清理。

2. 验证混淆结果 #

添加完规则后，构建混淆包，然后查看build/outputs/mapping/release/mapping.txt文件：

• 确认com.example.android.MyRetrofitService$DELETE_WITH_A_BODY没有被重命名；
• 确认接口中使用@DELETE_WITH_A_BODY的方法，其注解信息依然存在（没有被标记为移除）。

如果mapping文件里这些内容都保留了，那问题基本就解决了。

3. 额外注意事项 #

如果你的项目中还有其他自定义Retrofit注解，或者用到了Retrofit的其他注解（比如@Body、@Query），也要按照类似的规则保留它们——核心就是不让Proguard动任何Retrofit需要通过反射读取的注解类和元数据。

内容的提问来源于stack exchange，提问作者A. Rager