Flutter在VSCode运行项目报错：任务':app:checkDebugAarMetadata'执行失败

:app:checkDebugAarMetadata任务执行失败，核心原因为依赖版本与项目编译SDK版本不匹配：

执行com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction时出现故障，依赖androidx.work:work-runtime:2.7.0-rc01的AAR元数据（META-INF/com/android/build/gradle/aar-metadata.properties）中指定的minCompileSdk(31)，高于当前模块配置的compileSdkVersion(30)，触发编译校验失败。

方案1（推荐）：升级项目编译SDK版本 #

找到app模块下的build.gradle文件，修改android配置块中的compileSdk参数：

android {
    // 将原有compileSdk的取值从30修改为31
    compileSdk 31

    defaultConfig {
        // 可选操作：同步将targetSdk升级为31，保证配置一致性
        targetSdk 31
        // 其余原有配置保持不变
    }
}

修改完成后同步Gradle，重新执行构建即可。

方案2：降级work-runtime依赖版本 #

如果暂时不需要高版本work-runtime的新特性，不想升级编译SDK，可以将该依赖降级到适配compileSdk 30的版本，比如2.6.0：
修改build.gradle文件中的依赖配置：

dependencies {
    // 将原有androidx.work:work-runtime的版本号从2.7.0-rc01修改为2.6.0
    implementation 'androidx.work:work-runtime:2.6.0'
}

修改完成后同步Gradle重新构建即可。

调试排查参数 #

如果需要进一步排查构建问题，可在执行构建命令时添加对应参数获取更多信息：

• 添加--stacktrace参数可获取完整堆栈跟踪信息
• 添加--info或--debug参数可获取更详细的日志输出
• 添加--scan参数可获取完整的构建分析报告

内容的提问来源于stack exchange，提问作者Noor Kh.