迁移至AndroidX后Retrofit接口出现Kapt NonExistentClass异常

我来帮你一步步排查并解决这个AndroidX迁移后遇到的Retrofit编译异常问题：

问题根源拆解 #

1. 第一个异常 NonExistentClass cannot be converted to Annotation：这是因为Kapt在处理Retrofit的Java注解（比如@GET、@Query）时，由于依赖版本不兼容或AndroidX迁移导致的类路径变更，无法找到这些注解的实际类定义，所以将其标记为NonExistentClass。
2. 第二个异常 ClassCastException: Type$ErrorType cannot be cast to Type$ArrayType：开启correctErrorTypes = true后，Kapt尝试修复错误类型，但旧版本Retrofit与Kotlin插件的类型处理逻辑存在冲突，进而触发类型转换失败。

具体解决步骤 #

1. 升级依赖到AndroidX兼容版本 #

你的Retrofit版本（2.4.0）对AndroidX的支持不完善，建议升级到最新稳定版，同时确保Kotlin版本与插件版本匹配：

• 在项目根目录build.gradle中，设置Kotlin版本为1.3.x及以上（例如ext.kotlin_version = "1.3.72"）
• 在app模块build.gradle中更新Retrofit依赖：

implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

2. 调整Android编译配置 #

替换预览版的编译SDK为稳定版本，避免兼容性隐患：

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.3"
    defaultConfig {
        // 保留原有配置，仅更新targetSdkVersion
        targetSdkVersion 29
    }
}

3. 优化Kapt配置 #

保留correctErrorTypes配置的同时，添加javac选项增强错误处理能力：

kapt {
    correctErrorTypes = true
    javacOptions {
        option("-Xmaxerrs", 500) // 增加错误输出数量，方便排查隐藏问题
    }
}

4. 清理缓存并重建项目 #

AndroidX迁移后缓存可能残留旧类路径信息，必须执行以下操作：

• 点击Build -> Clean Project
• 点击Build -> Rebuild Project
• 手动删除项目根目录的.gradle文件夹和app模块的build文件夹
• 重启Android Studio

5. 检查ApiService代码细节 #

确保Call<...>中的泛型是实际存在的实体类（比如Call<PopularResponse>），避免使用占位符导致的隐性类型错误。

验证效果 #

完成上述步骤后重新同步项目并运行，这两个编译异常应该就能解决。如果仍有问题，可以检查是否存在未迁移到AndroidX的第三方依赖，这类依赖也可能引发冲突。

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