Android Studio更新后旧项目无法运行，Kotlin方法找不到报错求解决

• Kotlin Gradle插件与Gradle版本不兼容：Android Studio更新后，默认的Gradle或Kotlin插件版本会升级，但项目中遗留的旧版插件与新版本Gradle不匹配，目标方法属于特定版本的Kotlin插件API，版本错位就会导致方法缺失。
• 第三方插件依赖过时的Kotlin API：项目中使用的部分第三方Gradle插件（如自定义插件、Hilt/Room等官方插件的旧版本）依赖的Kotlin插件API与当前项目版本不一致，调用了已移除或未实现的方法。
• 局部缓存未彻底清理：虽然执行了系统提示的重新下载依赖，但项目或用户目录中仍残留旧版插件的缓存文件，导致构建时加载了错误的类文件。

1. 对齐Kotlin Gradle插件与Gradle版本 #

打开项目根目录的build.gradle（或build.gradle.kts）文件，将kotlin-gradle-plugin版本调整为与当前Android Studio适配的版本（可参考AS右上角同步提示的推荐版本），同时确保Android Gradle Plugin（AGP）版本也匹配AS版本。
示例修改：

// 根目录build.gradle
dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20"
    classpath "com.android.tools.build:gradle:8.2.1"
}

修改后执行「File → Sync Project with Gradle Files」，按提示下载对应版本的Gradle。

2. 升级第三方Gradle插件 #

检查项目中所有第三方插件（如Hilt、Navigation、Room等）的版本，升级到与当前Kotlin插件兼容的最新版本。例如Hilt 2.49+适配Kotlin 1.9.x版本。
示例修改：

// app模块build.gradle
implementation "com.google.dagger:hilt-android:2.49"
kapt "com.google.dagger:hilt-compiler:2.49"

3. 彻底清理Gradle缓存 #

关闭Android Studio，手动删除以下目录：

• 项目根目录下的.gradle文件夹
• 用户目录下的.gradle/caches文件夹（Windows：C:\Users\<你的用户名>\.gradle\caches；Mac：~/Users/<你的用户名>/.gradle/caches）
• 所有模块下的build文件夹
  重新打开Android Studio后执行同步操作，让系统重新下载所有依赖和插件。

4. 禁用Gradle守护进程并重启 #

在项目根目录的gradle.properties文件中添加或修改：

org.gradle.daemon=false

关闭AS，杀死所有Gradle相关进程（Windows任务管理器结束gradle.exe；Mac终端执行killall gradle），重新打开AS并同步项目。同步完成后可按需将org.gradle.daemon改回true。

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