更新Android Studio 3.1后新建Kotlin项目构建配置失败求助

别着急，我之前升级到AS 3.1后新建Kotlin模块时也碰到过几乎一模一样的配置报错，给你几个亲测有效的排查和解决方向：

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

AS 3.1对Kotlin插件和Gradle版本有特定的兼容性要求，建议你这样检查：

• 打开项目根目录的Project级build.gradle，确认Kotlin插件版本和Gradle插件版本：

  buildscript {
      ext.kotlin_version = '1.2.30' // 这个版本和AS 3.1适配性最佳
      repositories {
          google()
          jcenter()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:3.1.0'
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
      }
  }
  

• 再看gradle/wrapper/gradle-wrapper.properties里的Gradle分发版本：

  distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip
  

  如果版本不对，改成上面的配置试试。

2. 确认:app模块的Kotlin配置完整 #

新建模块可能没自动补全所有Kotlin配置，检查:app模块的build.gradle：

• 顶部必须添加Kotlin插件声明：

  apply plugin: 'com.android.application'
  apply plugin: 'kotlin-android'
  apply plugin: 'kotlin-android-extensions' // 如果你用了视图绑定扩展的话
  

• 依赖里要包含Kotlin标准库：

  dependencies {
      implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
      // 其他项目依赖...
  }
  

3. 清理缓存并重启同步 #

缓存紊乱是这类配置问题的常见诱因，按这个流程操作：

• 点击AS工具栏的File -> Invalidate Caches / Restart...，选择Invalidate and Restart
• 重启后点击工具栏的Sync Project with Gradle Files按钮重新同步项目

4. 排查依赖冲突 #

如果项目里加了第三方库，可能和Kotlin依赖版本冲突。你可以在终端执行./gradlew app:dependencies查看完整依赖树，找到重复的Kotlin相关依赖后，用exclude排除冲突部分：

implementation('com.example:some-third-lib:1.0.0') {
    exclude group: 'org.jetbrains.kotlin'
}

5. 检查本地Gradle网络配置 #

离线模式或代理异常会导致依赖下载失败，进而触发配置报错：

• 关闭离线模式：File -> Settings -> Build, Execution, Deployment -> Gradle，取消勾选Offline work
• 确认代理设置正常，能访问Google和JCenter仓库

要是这些方法都试过还没解决，你可以把:app模块的完整build.gradle内容和详细错误栈贴出来，能更精准定位问题~

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