Android Studio中kotlinx.serialization编译插件失效问题求助

问题根源 #

你的build.gradle.kts (:app)配置中缺少kotlinx.serialization编译插件的引用——虽然已经添加了序列化库的依赖，但编译插件是处理@Serializable注解的核心组件，必须显式启用才能生效。

修复步骤 #

1. 添加编译插件到app模块配置
   在build.gradle.kts (:app)的plugins块中新增序列化插件引用：

   plugins {
       id("com.android.application")
       id("org.jetbrains.kotlin.android")
       id("org.jetbrains.kotlin.plugin.serialization") // 新增该行
   }
   

2. 保证版本兼容性（可选但推荐）
   序列化插件版本需要和项目使用的Kotlin版本保持一致。如果项目未通过settings.gradle.kts统一管理插件版本，可以显式指定版本号（与org.jetbrains.kotlin.android版本相同即可）：

   id("org.jetbrains.kotlin.plugin.serialization") version "1.8.22" // 替换为你的Kotlin实际版本
   

   同时建议kotlinx-serialization-json依赖版本与插件版本兼容，避免出现版本不匹配问题。

3. 清理缓存并同步项目

   • 点击Android Studio工具栏的Sync Project with Gradle Files按钮同步配置
   • 执行File > Invalidate Caches...，勾选Invalidate and Restart重启IDE，清除可能损坏的缓存

额外说明 #

之前配置正常突然报错，大概率是IDE缓存损坏、Gradle同步异常，或者依赖/插件版本在自动同步时出现不匹配导致的。按上述步骤修复后即可恢复正常。

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