Flutter 3.29.1构建失败：':gradle:compileKotlin'任务执行出错

问题根源 #

Flutter 3.29.1主分支内置的Gradle依赖检查脚本，与Gradle 8.12、当前环境的Kotlin版本存在兼容性冲突，导致Version类引用无法被解析，最终触发:gradle:compileKotlin任务失败。

可行解决步骤 #

1. 强制指定兼容的Kotlin版本 #

在项目根目录的build.gradle（或build.gradle.kts）中，设置适配Gradle 8.12的稳定Kotlin版本：

// Groovy格式build.gradle
buildscript {
    ext.kotlin_version = '1.9.23'
    // 保留原有其他配置
}

// Kotlin格式build.gradle.kts
buildscript {
    extra["kotlin_version"] = "1.9.23"
    // 保留原有其他配置
}

2. 降级Gradle版本（步骤1无效时尝试） #

修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl，切换到Flutter 3.29.x官方推荐的兼容版本：

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

3. 清理缓存后重新构建 #

执行以下命令清除缓存并重建项目：

flutter clean
# Linux/Mac系统执行：rm -rf ~/.gradle/caches
# Windows系统手动删除C:\Users\<你的用户名>\.gradle\caches文件夹
flutter pub get
flutter run

4. 临时禁用报错脚本（应急方案） #

找到dependency_version_checker.gradle.kts第156行附近的Version相关代码块，用/* */包裹注释，再重新构建。此为临时方案，后续建议升级Flutter到修复该问题的版本。

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