无Android Studio环境下Flutter运行Gradle assembleDebug失败求助

1. 先获取详细错误信息 #

直接运行 flutter run 仅会显示笼统错误，建议进入项目的 android 目录，执行以下命令获取堆栈跟踪：

gradlew assembleDebug --stacktrace

这会输出具体的失败原因（如依赖冲突、路径错误或版本不兼容等），是定位问题的关键。

2. 检查 Flutter Doctor 状态 #

执行以下命令查看环境配置是否存在遗漏：

flutter doctor -v

重点关注：

• Android SDK 组件是否齐全（例如是否缺少 cmdline-tools）
• JDK 配置是否被正确识别
• Flutter SDK 路径是否正常

3. 修复 local.properties 文件 #

由于未安装 Android Studio，项目的 local.properties 可能缺少 Android SDK 路径配置。添加以下内容到该文件（替换为你的实际 SDK 路径）：

flutter.sdk=C:\\path\\to\\your\\flutter-sdk
android.sdk.path=C:\\path\\to\\your\\android-sdk

即使已设置 ANDROID_SDK_ROOT，Gradle 有时仍会优先读取此文件中的配置。

4. 调整 Java 版本兼容性 #

你使用的是 JDK 19，但项目编译配置指定的是 Java 8。虽然 JDK 19 可向下兼容，但部分 Gradle 插件可能对新版本 JDK 存在兼容性问题。建议：

• 暂时切换到 JDK 11（Flutter 官方推荐版本），更新 JAVA_HOME 环境变量后重启终端
• 或在项目的 android/build.gradle 中添加 Gradle 工具链配置，强制使用 Java 8 编译：

android {
    // ... 其他配置
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
        coreLibraryDesugaringEnabled true
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
    // ... 其他依赖
}

5. 确认 Gradle 与 Flutter 版本兼容性 #

Gradle 8.0.2 需要对应的 Android Gradle Plugin (AGP) 版本支持，而 Flutter 会自动引入 AGP。检查你的 Flutter 版本：

flutter --version

• Flutter 3.10+ 兼容 Gradle 7.5-8.2
• 若你的 Flutter 版本低于 3.10，建议将 Gradle 版本降级到 7.4.2（修改 gradle-wrapper.properties 中的 distributionUrl）

6. 检查 Kotlin 版本配置 #

项目的 android/build.gradle 根文件中需要定义 Kotlin 版本，确保其与 AGP 兼容。添加或更新以下内容：

buildscript {
    ext.kotlin_version = '1.7.20' // 与 AGP 7.4+ 兼容的版本
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:7.4.2"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

7. 清理并重新构建 #

完成上述调整后，执行以下命令重置构建缓存：

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

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