Android Studio 3.1稳定版更新后Kotlin项目Gradle同步报错求助

嘿，这个问题我之前帮不少开发者处理过，AS 3.1稳定版更新后出现这类依赖下载失败的情况，大多是离线模式没关闭或者依赖版本太旧导致的，给你几个具体的解决步骤，一步步来应该就能搞定：

第一步：先关掉Gradle的离线模式 #

这是最常见的原因，离线模式下Gradle不会去远程仓库拉取新的依赖，而你本地又没有这个旧版本的缓存，自然就报错了：

• 打开Android Studio，顶部菜单栏点 File → Settings（Windows/Linux）或者 Android Studio → Preferences（Mac）
• 在设置窗口里找到 Build, Execution, Deployment → Build Tools → Gradle
• 找到 Offline work 这个选项，把它前面的勾去掉，然后点 OK 保存设置

第二步：更新Kotlin依赖版本 #

AS 3.1稳定版对应的Kotlin版本早就比1.1.3-2新很多了，这个旧版本可能已经从远程仓库下架或者不再被支持，更新到适配的版本就好：

1. 打开项目根目录下的 build.gradle（注意是Project级别的那个，不是模块的），找到Kotlin版本的配置代码：

   buildscript {
       ext.kotlin_version = '1.1.3-2' // 这里是过时的旧版本
       repositories {
           google()
           jcenter()
       }
       dependencies {
           classpath 'com.android.tools.build:gradle:3.1.0'
           classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
       }
   }
   

2. 把 ext.kotlin_version 的值改成AS 3.1兼容的版本，比如 '1.2.41'（这个版本是当时和AS 3.1适配性很好的版本，你也可以用AS提示的最新兼容版本）
3. 再打开模块级别的 build.gradle，找到依赖里的 kotlin-reflect，确保它的版本和根目录配置的一致：

   dependencies {
       implementation "org.jetbrains.kotlin:kotlin-reflect:$kotlin_version"
   }
   

第三步：清理缓存并重启AS #

有时候缓存会出问题，清理后重新同步就能解决：

• 顶部菜单栏点 File → Invalidate Caches / Restart
• 在弹出的窗口里选择 Invalidate and Restart，耐心等AS重启并重新构建项目就好

第四步：检查仓库配置 #

确保根目录的 build.gradle 里配置了正确的远程仓库，这样Gradle才能拉到依赖：

allprojects {
    repositories {
        google()
        jcenter()
    }
}

如果以上步骤都试过还是不行，你可以手动去下载对应的jar包放到Gradle本地缓存目录，但更推荐更新依赖版本，毕竟旧版本可能存在兼容性问题，后续还会引发其他麻烦。

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