Flutter项目构建报错：无法获取usesUnsupportedDependencyVersions属性

复现步骤 #

• 执行命令：melos clean && melos bootstrap
• 执行命令：fvm flutter pub get
• 执行命令：fvm flutter pub upgrade
• 执行命令：fvm flutter pub run build_runner clean
• 执行命令：fvm flutter pub run build_runner build --delete-conflicting-outputs
• 运行项目

错误详情 #

构建失败并抛出异常：

• 位置：构建文件 /Users/herisarwanto/AndroidStudioProjects/FREELANCE/99Group/NEW-Rumah123-Pro/rumah123-pro-apps/packages/app/android/app/build.gradle 第4行
• 问题原因：应用插件 dev.flutter.flutter-gradle-plugin 时发生异常，无法应用该插件，且无法获取项目:app（类型为org.gradle.api.Project）的未知属性usesUnsupportedDependencyVersions
• 官方调试提示：使用--stacktrace选项获取堆栈跟踪；使用--info或--debug选项获取更多日志输出；使用--scan选项获取完整分析信息

最终提示：BUILD FAILED in 2s，错误：Gradle任务assembleDevDebug失败，退出码为1

解决方案 #

1. 对齐Flutter与Gradle版本兼容性 #

不同Flutter版本对应不同的Gradle版本要求，执行flutter doctor查看当前Flutter版本推荐的Gradle版本，然后修改项目根目录下android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

# 示例：使用Gradle 8.6版本
distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-all.zip

2. 更新Flutter Gradle插件版本 #

打开项目android/build.gradle文件，修改flutter-gradle-plugin版本以匹配当前Flutter版本：

dependencies {
    // 替换x.y.z为对应Flutter版本的插件版本，比如Flutter 3.19对应2.2.0
    classpath "dev.flutter:flutter-gradle-plugin:x.y.z"
}

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

执行以下命令清理缓存并重新执行构建步骤：

fvm flutter clean
melos clean && melos bootstrap
fvm flutter pub get
fvm flutter pub run build_runner build --delete-conflicting-outputs

4. 排查自定义Gradle配置冲突 #

检查android/app/build.gradle或项目中其他Gradle配置文件，确认是否存在自定义属性、插件与Flutter Gradle插件冲突，可暂时注释可疑配置后重新测试。

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