Flutter项目:app:compileDebugKotlin任务执行失败，无法解析引用问题求助

看起来你在构建Flutter项目时踩了Kotlin编译的坑，核心是MainActivity.kt里的io和FlutterActivity引用找不到，直接导致assembleDebug任务跑崩了。我来帮你梳理下可能的问题点和对应的解决办法：

核心错误日志 #

Running Gradle task 'assembleDebug'...
e: file:///D:/Flutter%20projects/ViserBank%20v2.0%20App/Files/android/app/src/main/kotlin/dev/vlab/viser_bank/MainActivity.kt:3:8 Unresolved reference 'io'.
e: file:///D:/Flutter%20projects/ViserBank%20v2.0%20App/Files/android/app/src/main/kotlin/dev/vlab/viser_bank/MainActivity.kt:5:21 Unresolved reference 'FlutterActivity'.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:compileDebugKotlin'.
> A failure occurred while executing org.jetbrains.kotlin.compilerRunner.GradleCompilerRunnerWithWorkers$GradleKotlinCompilerWorkAction
> Compilation error. See log for more details

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

BUILD FAILED in 10m 29s
Error: Gradle task assembleDebug failed with exit code 1

你的项目关键配置片段 #

settings.gradle

pluginManagement {
    def flutterSdkPath = {
        def properties = new Properties()
        file("local.properties").withInputStream { properties.load(it) }
        def flutterSdkPath = properties.getProperty("flutter.sdk")
        assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
        return flutterSdkPath
    }
    settings.ext.flutterSdkPath = flutterSdkPath()
    includeBuild("${settings.ext.flutterSdkPath}/packages/flutter_tools/gradle")
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
plugins {
    //id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    // Update Gradle and Kotlin versions here
    id "com.android.application" version '8.7.0' apply false
    id "org.jetbrains.kotlin.android" version "2.0.20" apply false
    //id "com.google.gms.google-services" version "4.4.2" apply false
    //id "com.google.firebase.crashlytics" version "3.0.2" apply false
    id "org.gradle.toolchains.foojay-resolver-convention" version "0.8.0"
}
include ":app"

gradle.properties

org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError
android.useAndroidX=true
android.enableJetifier=true

app/build.gradle

plugins {
    id 'com.android.application'
    id 'kotlin-android'
    id 'dev.flutter.flutter-gradle-plugin'
    //id 'com.google.gms.google-services'
    //id 'com.google.firebase.crashlytics'
}

// If local properties file doesn't exist, use some default values if possible
def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader -> localProperties.load(reader) }
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

// Update Android SDK versions here
def flutterCompileSdkVersion = 35
def flutterMinSdkVersion = 24 // Android 7.0
def flutterTargetSdkVersion = 35

kotlin {
    jvmToolchain(17) // Java version defined here
}

android {
    namespace 'dev.vlab.viser_bank'
    compileSdk flutterCompileSdkVersion

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        applicationId 'dev.vlab.viser_bank'
        minSdkVersion flutterMinSdkVersion
        targetSdkVersion flutterTargetSdkVersion
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    buildTypes {
        debug {
            // This differentiated release from debug build, but it prevented debug build from
            // seeing subscription products. See also `android/app/src/debug/google-services.json`.
            //applicationIdSuffix '.debug'
            debuggable true
        }
        release {
            // TODO: Add your own signing config for the release build.
            // Signing with the debug keys for now, so `flutter run --release` works.
            signingConfig signingConfigs.debug
        }
    }

    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
    }
}

问题排查与解决办法 #

1. 先修复最直接的：MainActivity.kt 导入缺失

这个是报错的核心——代码里找不到io和FlutterActivity，大概率是你的MainActivity.kt缺少必要的导入语句，甚至文件内容损坏了。

操作步骤：
打开D:/Flutter projects/ViserBank v2.0 App/Files/android/app/src/main/kotlin/dev/vlab/viser_bank/MainActivity.kt，把内容替换成下面的基础模板（确保包名和你的项目一致）：

package dev.vlab.viser_bank

import io.flutter.embedding.android.FlutterActivity

class MainActivity : FlutterActivity() {
    // 不需要额外代码的话，基础继承FlutterActivity就够了
}

2. 调整Gradle插件版本兼容

你用的Kotlin 2.0.20是比较新的版本，而Android Gradle Plugin（AGP）是8.1.0，两者可能和你的Flutter SDK版本不兼容（新版本Kotlin对AGP版本要求更高）。

操作步骤：

1. 先查自己的Flutter版本：打开终端运行flutter --version
2. 根据Flutter版本调整Kotlin版本：
   • 如果是Flutter 3.16+，推荐Kotlin 1.9.20
   • 如果是Flutter 3.10-3.15，推荐Kotlin 1.8.22
3. 修改settings.gradle里的Kotlin版本：

   id "org.jetbrains.kotlin.android" version "1.9.20" apply false
   

4. 同步项目后，执行flutter clean，再重新构建。

3. 解决路径与同步问题

你的项目路径里有空格（比如ViserBank v2.0 App），Gradle对带空格的路径经常出现解析异常，建议把整个项目移到无空格、无特殊字符的路径下，比如D:/FlutterProjects/ViserBankV2。

另外，检查local.properties里的flutter.sdk路径是否正确，指向你的Flutter SDK根目录，然后依次执行：

flutter pub get
flutter clean
cd android
./gradlew clean
flutter run

4. 确认JDK版本配置

你配置了JVM Toolchain 17，要确保系统里确实安装了JDK 17，并且Gradle能识别到：

• 运行java -version检查当前JDK版本，如果不是17，就在local.properties里添加：

  org.gradle.java.home=你的JDK17安装路径（比如C:/Program Files/Java/jdk-17.0.10）
  

内容来源于stack exchange