R8与ProGuard问题：含@Keep注解的数据类出现缺失类错误

我们的一个数据类在构建过程中被混淆或移除，因此为其添加了@Keep注解以解决该问题，代码如下：

@Keep
data class CommonNotification(
    val title: String,
    val description: String,
    val channel: String,
    val action: String = DEFAULT_VALUE_STRING,
    val actionData: String? = DEFAULT_VALUE_STRING,
    val bigImage: String? = DEFAULT_VALUE_STRING,
    val environment: String = BuildConfig.BUILD_TYPE
)

但运行./gradlew lint时失败，出现R8缺失类错误：

Missing classes detected while running R8. Please add the missing classes or apply additional keep rules that are generated in
/Users/user/Desktop/Projects/Mobile/Android/App/app/libs/AndroidCommon/build/outputs/mapping/debug/missing_rules.txt.

ERROR: R8: Missing class java.lang.invoke.StringConcatFactory (referenced from: java.lang.String com.project.android.common.data.remote.responses.notifications.CommonNotification.toString())

尝试添加-dontwarn java.lang.invoke.StringConcatFactory规则，但规则文件中出现“Unresolved class name”警告/错误。当前使用Java 17和AGP 8.1.1，请问问题原因及解决方案是什么？

1. API兼容性差异：StringConcatFactory是Java 9引入的类，Android ART运行时仅在API 26（Android 8.0）及以上版本提供支持。用Java 17编译时，Kotlin编译器默认会用这个类生成data class的toString()方法，R8分析代码时会检测到低版本Android中不存在该类，从而抛出缺失类错误。
2. Lint与R8的联动逻辑：AGP 8.1.1中，Lint任务会触发R8的代码分析流程，即使仅执行Lint，也会进行混淆相关检查，进而暴露了这个兼容性问题。
3. 规则解析严格性：R8在Java 17环境下对混淆规则的解析更严格，直接引用Android SDK中不存在的类，会被判定为无效规则，导致“Unresolved class name”报错。

方案一：强制Kotlin使用旧字符串拼接逻辑 #

在模块的build.gradle.kts（或Groovy版build.gradle）中添加编译参数，让Kotlin生成内联的字符串拼接代码，避免依赖StringConcatFactory：

// build.gradle.kts
tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
    kotlinOptions {
        freeCompilerArgs += listOf("-Xstring-concat=inline")
    }
}

Groovy版本：

// build.gradle
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
    kotlinOptions {
        freeCompilerArgs += ['-Xstring-concat=inline']
    }
}

方案二：调整R8混淆规则 #

在混淆规则文件（如proguard-rules.pro）中添加以下规则，同时兼顾兼容性与规则有效性：

-keep class java.lang.invoke.StringConcatFactory {*;}
-dontwarn java.lang.invoke.StringConcatFactory

如果你的App最低兼容版本（minSdk）是26及以上，可直接跳过此规则——因为该版本已经内置StringConcatFactory，问题会自动消失。若minSdk低于26，上述规则会让R8忽略该类的缺失，运行时高版本设备会正常使用该类，低版本设备则会自动 fallback 到旧的拼接逻辑。

方案三：升级AGP版本 #

AGP 8.1.x存在部分Java 17与R8的兼容性小问题，升级到AGP 8.2及以上版本（如8.2.2），官方已修复此类问题，无需额外配置即可解决报错。

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