添加cloud_firestore包后Flutter应用无法运行，尝试官方前两种方案仍无效

DevOps 小满

2026-9-25

解决方案

确认minSdk修改生效
很多Flutter项目默认不会直接在android/app/build.gradle的defaultConfig块写死minSdk数值，而是引用全局变量：
```
defaultConfig {
    minSdkVersion flutter.minSdkVersion
}
```
你可以直接把这里替换成固定数值即可：
```
defaultConfig {
    minSdkVersion 19
}
```
不需要修改其他位置的配置，确保只有这一处控制minSdk数值即可。
清理缓存重新构建
修改配置后先执行以下命令清除旧构建缓存：
```
flutter clean
```
再手动删除项目下android/.gradle文件夹，之后执行flutter pub get重新拉取依赖，再启动应用测试即可。
检查firebase系列依赖版本兼容性
确保项目中所有firebase相关依赖（比如firebase_core、firebase_auth等）的大版本互相兼容，不要跨大版本混用，推荐全部升级到官方兼容的最新正式版。
适配低版本安卓的临时方案
如果你确实需要支持安卓SDK版本低于19的设备，可以强制覆写版本限制：
1. 打开android/app/src/main/AndroidManifest.xml，在根manifest标签添加tools命名空间：
```
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
```
2. 在application标签内添加覆写配置：
```
<uses-sdk tools:overrideLibrary="io.flutter.plugins.firebase.firestore" />
```
该方案可能导致应用在安卓SDK低于19的设备上运行时出现崩溃，仅推荐临时测试使用。
升级Android Gradle配置
如果以上操作都无效，检查android/build.gradle中的Android Gradle插件版本是否低于7.0，低于的话升级到7.0+，同时将android/gradle/wrapper/gradle-wrapper.properties中的Gradle版本升级到与之匹配的7.0+版本。