Android项目替换Retrofit为Ktor后Release构建序列化异常求助

Debug构建正常，但Release下@Serializable相关序列化报错，核心问题是混淆（ProGuard/R8）破坏了序列化所需的类结构或序列化器，以下是针对性解决方案：

1. 对齐Kotlin序列化插件与依赖版本 #

项目级插件版本为1.6.21，需确保kotlinx.serialization.json的版本与Kotlin版本、插件版本严格匹配（比如Kotlin 1.6.21对应serialization.json 1.3.2）。版本不匹配会导致运行时序列化器加载异常。

2. 补全ProGuard/R8规则 #

现有规则覆盖不全，添加以下规则到ProGuard配置文件：

# 保留所有带@Serializable注解的类及其成员
-keep @kotlinx.serialization.Serializable class ** { *; }

# 保留序列化核心库类，避免被混淆移除
-keep class kotlinx.serialization.** { *; }
-keep class kotlinx.serialization.json.** { *; }

# 确保序列化器方法不被优化
-if @kotlinx.serialization.Serializable class ** {
    public static **$Companion Companion;
}
-keepclassmembers class <1>$Companion {
    kotlinx.serialization.KSerializer serializer();
}

# 保留data class的构造函数参数名（避免R8重命名导致字段匹配失败）
-keepclassmembers class ** {
    @kotlinx.serialization.Serializable <fields>;
}

如果开启了R8 full mode，还需添加：

-keep class kotlinx.serialization.internal.** { *; }

3. 检查应用级插件是否启用序列化 #

项目级仅设置了apply false，需在应用级build.gradle.kts中显式应用插件：

plugins {
    // 其他插件...
    id("org.jetbrains.kotlin.plugin.serialization")
}

4. 验证Ktor JsonFeature配置 #

确保Json序列化器配置正确，避免冲突：

install(JsonFeature) {
    serializer = KotlinxSerializer(Json {
        ignoreUnknownKeys = true
        isLenient = true
        // 显式保留字段名，防止R8重命名后匹配失败
        encodeDefaults = true
    })
}

5. 开启Release日志定位具体错误 #

在Release构建中保留Ktor日志，查看具体序列化异常信息：

install(Logging) {
    level = LogLevel.ALL
    logger = object : Logger {
        override fun log(message: String) {
            android.util.Log.d("KtorSerial", message)
        }
    }
}

通过日志可以精准定位是哪个类的序列化器丢失，或哪个字段匹配失败。

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