You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter集成Firebase应用构建失败:Manifest合并失败(minSdkVersion版本不兼容)

Flutter集成Firebase应用构建失败:Manifest合并失败(minSdkVersion版本不兼容)

我完全懂你现在的困扰——Firebase Auth库的最低SDK版本要求和你项目的设置撞了,而且你改了配置还没生效,肯定急得不行对吧?别担心,咱们来一步步解决这个问题。

首先明确问题根源:错误提示已经说得很清楚了,你引入的firebase_auth库要求项目的minSdkVersion至少是23,但你的项目当前设置的是21,所以Android的Manifest合并工具就报错了。你之前尝试修改minSdkVersion到23没生效,大概率是修改的位置不对,或者没同步项目、清理缓存。

下面给你两个可行的解决方案,优先推荐第一个,因为更稳妥:

方案一:升级项目的minSdkVersion到23及以上(推荐)

这是最安全的做法,因为Firebase Auth库从某个版本开始就不再支持API21及以下的系统了,升级后能避免后续出现更多兼容性问题。

  • 找到你Flutter项目里的android/app/build.gradle文件(注意是app子目录下的build.gradle,不是项目根目录的那个)
  • 找到defaultConfig代码块,把minSdkVersion改成23或者更高的版本,示例代码如下:
android {
    defaultConfig {
        // 这里保留你原来的其他配置,比如applicationId、versionCode这些
        minSdkVersion 23
        targetSdkVersion 33 // 可以根据你的需求调整,建议用最新的稳定版API
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }
}
  • 修改完成后,点击Android Studio右上角的「Sync Now」按钮同步配置;如果是用终端操作,先执行flutter clean清除旧的构建缓存,再执行flutter pub get,最后重新构建项目就行。

方案二:强制覆盖库的minSdk要求(不推荐,有运行风险)

如果你因为某些特殊需求必须保留minSdkVersion 21,可以用tools:overrideLibrary强制让Manifest合并通过,但要注意:这可能会导致你的App在Android 5.0(API21)及以下的设备上运行时崩溃,因为Firebase Auth可能用到了API23才有的系统API。

  • 打开android/app/src/main/AndroidManifest.xml文件
  • 先在<manifest>标签里添加tools命名空间,然后在<application>标签上加上tools:overrideLibrary属性,示例代码如下:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.your.app.package"> <!-- 这里替换成你自己的包名 -->

    <application
        tools:overrideLibrary="io.flutter.plugins.firebase.auth"
        android:label="你的App名称"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">
        <!-- 这里保留你原来的Application配置内容 -->
    </application>
</manifest>
  • 同样,修改后记得同步项目或者清理缓存再构建。

最后再提醒一下:如果你之前修改minSdkVersion没生效,检查一下是不是改了根目录的android/build.gradle而不是app目录下的,那个文件里的配置是给所有模块用的,但app模块的配置会覆盖它,所以一定要改对地方哦!

备注:内容来源于stack exchange,提问作者Abdelrhman omar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.15 12:08:09