Android Studio模拟器运行Flutter项目报错但Kotlin项目正常如何解决

由于相同模拟器运行Kotlin项目正常，可排除模拟器本身、Android基础环境的故障，问题集中在Flutter环境或项目的Android侧配置上，可按以下步骤依次排查：

第一步：验证Flutter环境完整性 #

• 运行flutter doctor命令，检查Android toolchain相关配置项是否全部打勾，重点关注是否存在Android license status unknown、Android SDK version mismatch类报错
• 如果存在证书异常，执行flutter doctor --android-licenses按照提示同意全部许可即可
• 确认Flutter项目的Android SDK路径与Android Studio全局配置的SDK路径一致，打开项目下的android/local.properties文件，检查sdk.dir配置值是否和正常运行的Kotlin项目所用SDK路径匹配，不匹配直接替换为正确路径即可

第二步：检查项目级Android配置 #

• 打开android/app/build.gradle文件，确认minSdkVersion配置值不低于当前运行模拟器的Android系统版本：Flutter 3.0+默认minSdkVersion为21（对应Android 5.0），如果模拟器系统版本低于该值就会启动失败，直接修改为和正常运行的Kotlin项目相同的minSdkVersion即可
• 确认compileSdkVersion和targetSdkVersion版本与本地安装的Android SDK版本匹配，建议取值和正常运行的Kotlin项目对应配置保持一致

第三步：清理缓存重新构建 #

• 执行flutter clean清理项目构建缓存
• 执行flutter pub get重新拉取项目依赖
• 重启Android Studio和模拟器后再尝试运行项目

第四步：检查Gradle配置适配 #

• 如果上述步骤都无效，打开android/gradle/wrapper/gradle-wrapper.properties文件，确认gradle版本与Android Studio兼容，建议和正常运行的Kotlin项目的gradle版本保持一致
• 打开项目根目录的android/build.gradle，确认kotlin插件版本、Android gradle插件版本也和正常运行的Kotlin项目对齐

可选：国内网络环境适配 #

如果构建过程中出现依赖拉取失败的报错，在android/build.gradle中替换maven源为国内镜像源即可，同时可同步修改Flutter安装目录下packages/flutter_tools/gradle/flutter.gradle文件中的google、jcenter源为国内镜像，加速依赖拉取。

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