使用Room与KSP添加类型转换器时触发Storage已注册异常的解决及问询

在Android项目中使用Room配合KSP处理类型转换器时，每次新增类型转换器（比如处理List<String>的转换器），编译都会抛出以下异常：

java.lang.IllegalStateException: Storage for [C:\...\symbolLookups\id-to-file.tab] is already registered

已知临时缓解方案 #

• 执行Android Studio的Build -> Clean Project清理编译产物
• 通过File -> Invalidate Caches / Restart清除IDE缓存并重启
• 执行命令行./gradlew --stop终止Gradle守护进程后重新编译

永久修复/预防措施 #

1. 升级KSP与Room版本 #

该缓存冲突是KSP早期版本的已知问题，尤其常见于KSP 1.8.x及以下搭配Room 2.5.x的组合。升级到最新稳定版的KSP和Room（如KSP 1.9.x+、Room 2.6.x+），官方已修复部分缓存失效逻辑的bug。
示例Gradle配置：

// 项目根目录build.gradle.kts
plugins {
    id("com.google.devtools.ksp") version "1.9.20-1.0.14" apply false
}

// 模块build.gradle.kts
dependencies {
    implementation("androidx.room:room-runtime:2.6.1")
    ksp("androidx.room:room-compiler:2.6.1")
}

2. 禁用KSP增量编译（过渡方案） #

如果暂时无法升级版本，可在模块的build.gradle.kts中禁用KSP增量编译，强制每次全量编译：

ksp {
    incremental = false
}

注意：此操作会增加编译时间，仅作为临时过渡使用。

3. 添加自定义缓存清理任务 #

在Gradle中添加自定义任务，自动清理KSP的符号查找缓存目录，避免手动操作：

tasks.register<Delete>("cleanKspSymbolCache") {
    delete(fileTree("${project.buildDir}/ksp/symbolLookups"))
}

// 绑定到clean任务，执行clean时自动清理KSP缓存
tasks.named("clean") {
    dependsOn("cleanKspSymbolCache")
}

之后执行./gradlew clean即可自动清理KSP的符号缓存目录。

问题根源 #

该异常源于KSP的符号查找缓存机制，在处理Room类型转换器这类注解驱动的代码变更时，无法正确失效旧缓存文件，导致新编译时尝试重复注册同一缓存存储文件，最终触发冲突。

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