Retrofit正式包请求报错：Class无法转为ParameterizedType原因排查

在使用Retrofit发起请求时，为什么正式构建（release build）中会出现java.lang.Class cannot be cast to java.lang.reflect.ParameterizedType错误？

原因分析 #

这个错误的核心是Release构建的代码混淆（R8/ProGuard）移除了Retrofit与Gson工作所需的泛型类型信息：

• Debug构建未启用混淆，接口方法的返回类型、泛型签名等信息完整，Retrofit能正常解析请求的返回类型；
• Release模式下，R8会默认优化掉冗余的类型元数据，包括接口方法的泛型签名、返回类型的详细信息，导致Retrofit在尝试解析ApiService中getManufacturers()方法的返回类型时，无法正确获取ManufacturerResponse的泛型结构，进而抛出类型转换异常。

你当前添加的ProGuard规则虽然覆盖了数据类的保留，但缺少对Retrofit接口方法完整签名、核心泛型属性的保留，不足以阻止R8的过度优化。

解决方案 #

完善你的ProGuard规则，确保Retrofit和Gson所需的类型信息不被混淆，具体规则如下：

# 保留Retrofit核心类与接口的完整结构
-keep interface retrofit2.** { *; }
-keep class retrofit2.** { *; }

# 保留泛型签名、注解等关键元数据，这是Retrofit解析类型的核心
-keepattributes Signature, RuntimeVisibleAnnotations, RuntimeVisibleParameterAnnotations

# 保留API接口的所有方法签名，避免返回类型被混淆
-keep class com.byteflipper.ffsensitivities.service.ApiService { *; }
-keepclassmembers class com.byteflipper.ffsensitivities.service.ApiService {
    @retrofit2.http.* <methods>;
}

# 保留数据类的构造函数、字段，确保Gson能正常序列化/反序列化
-keep class com.byteflipper.ffsensitivities.data.** { *; }
-keepclassmembers class com.byteflipper.ffsensitivities.data.** {
    <init>(...);
    <fields>;
}

# Gson相关必要保留，避免核心类被优化
-keep class com.google.gson.** { *; }
-keepattributes EnclosingMethod

另外补充两个优化点：

1. 你的数据类使用了kotlinx.serialization.Serializable注解，但Retrofit配置的是GsonConverterFactory，该注解对Gson无效，若不需要Kotlin序列化框架，可直接移除；若要改用Kotlin序列化，需替换为KotlinxSerializationConverterFactory并添加对应依赖。
2. 确保Gradle的release构建配置中，正确引用了修改后的ProGuard规则文件。

内容的提问来源于stack exchange，提问作者IbremMiner837