Flutter复制项目构建失败 minCompileSdk(31)高于compileSdkVersion(30)

错误现象 #

将Flutter项目从原文件夹复制到新路径后，通过Android Studio打开无法完成构建，抛出如下错误：

FAILURE: Build failed with an exception.

问题定位 #

• 任务:app:checkDebugAarMetadata执行失败，触发多任务操作异常：
  • 执行com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction时出错：依赖项的AAR元数据（META-INF/com/android/build/gradle/aar-metadata.properties）中指定的minCompileSdk (31)，高于当前模块配置的compileSdkVersion (android-30)
    • 问题依赖：androidx.core:core-ktx:1.7.0
    • 对应AAR元数据文件路径：C:\Users\NTH.gradle\caches\transforms-2\files-2.1\518cb1a6f0b0a7c96a4aac4218e13c11\jetified-core-ktx-1.7.0\META-INF\com\android\build\gradle\aar-metadata.properties
  • 执行com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction时出错：依赖项的AAR元数据（META-INF/com/android/build/gradle/aar-metadata.properties）中指定的minCompileSdk (31)，高于当前模块配置的compileSdkVersion (android-30)
    • 问题依赖：androidx.core:core:1.7.0
    • 对应AAR元数据文件路径：C:\Users\NTH.gradle\caches\transforms-2\files-2.1\1978c8540575e4da29114a40e6bf1a1a\core-1.7.0\META-INF\com\android\build\gradle\aar-metadata.properties
• 最终构建状态：BUILD FAILED in 17s
• 根异常：Gradle任务assembleDebug执行失败，退出码为1

排查与修复方案 #

常规排查参数 #

构建时可追加以下参数获取更多定位信息：

• 加--stacktrace参数运行，获取完整错误堆栈
• 加--info或--debug参数运行，输出更详细的构建日志
• 加--scan参数运行，生成完整构建分析报告

针对性修复 #

报错核心原因是项目依赖的androidx.core:core:1.7.0、androidx.core:core-ktx:1.7.0两个库要求最低编译SDK版本为31，但当前项目配置的compileSdkVersion为30，版本不匹配，两种修复方案二选一即可：

1. 升级compileSdk版本（推荐）
   打开项目路径下的android/app/build.gradle文件，找到android配置块，将compileSdkVersion的值从30修改为31：

android {
    compileSdkVersion 31
    // 其余原有配置保持不变
    defaultConfig {
        // ...
    }
}

2. 锁定低版本core依赖（不想升级SDK时使用）
   如果暂时无法升级compileSdk版本，可打开项目路径下的android/build.gradle文件，添加全局依赖强制配置，将core相关库锁定为支持compileSdk 30的1.6.0版本：

subprojects {
    project.configurations.all {
        resolutionStrategy {
            force 'androidx.core:core-ktx:1.6.0'
            force 'androidx.core:core:1.6.0'
        }
    }
}

配置修改完成后，先在项目根目录执行以下命令清理缓存、重新拉取依赖，再同步Gradle即可正常构建：

flutter clean
flutter pub get

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