Android应用上传Google Play后参数名变更致API失效求助

问题现象 #

用Kotlin开发的Android应用，上传Google Play Console后所有API失效，排查发现参数名被自动修改：

• 本地调试/本地打包APK的请求参数：

{ "key":"My_Secret_Key", "fname":"First_Name", "lname":"Last_Name" }

• Play商店版本的请求参数：

{ "a":"My_Secret_Key", "b":"First_Name", "c":"Last_Name" }

已做排查：重复上传4-5次无效、测试其他应用无此问题、本地APK运行正常、日志确认参数格式差异、自行搜索资料+联系Google Play支持未获回复。

可能的解决方向 #

1. 混淆规则遗漏导致字段名被混淆 #

这是最常见的原因，R8/ProGuard在release构建时会混淆类和字段名，若用Gson、Moshi等序列化库处理请求参数，未配置好混淆规则就会出现这种情况。

• 给参数实体类添加序列化注解，明确指定字段名（以Gson为例）：

data class UserRequest(
    @SerializedName("key") val key: String,
    @SerializedName("fname") val fname: String,
    @SerializedName("lname") val lname: String
)

• 或者在proguard-rules.pro里添加规则，保留参数实体类的字段名：

# 替换为你的实体类所在包路径
-keep class com.yourapp.models.** { *; }
# Gson配套规则
-keepattributes *Annotation*
-keepclassmembers class * {
    @com.google.gson.annotations.SerializedName <fields>;
}

2. Google Play App Signing的额外优化 #

若开启了Google Play的应用签名服务，可能在签名过程中触发了额外的代码优化。可以尝试：

• 在本地使用Google Play提供的上传密钥或应用签名密钥打包release APK，安装到手机测试是否出现同样问题，以此判断是否是签名环节导致的。

3. 构建变体的配置差异 #

检查Module级build.gradle的release变体配置，确认是否开启了minifyEnabled true但未配套正确的混淆规则，而debug变体未开启混淆所以正常。示例配置：

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
        debug {
            minifyEnabled false
        }
    }
}

如果release开启了混淆但规则缺失，就会出现字段名被替换的情况。

4. 第三方依赖/插件的干扰 #

排查近期新增的依赖库或插件，比如隐私合规插件、性能优化插件，部分插件可能会在release构建时修改代码结构，导致参数字段名被替换。可以尝试临时移除新增的依赖/插件，重新打包上传测试。

内容的提问来源于stack exchange，提问作者Phaneendra Kumar Patnala