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

Flutter集成Firebase遇Failed to load FirebaseOptions错误求助

Flutter集成Firebase时出现Failed to load FirebaseOptions错误及白屏问题

我在Flutter中尝试实现Firebase的CRUD操作,已经添加了最新版本的Firebase依赖,完成了Firebase初始化,也更新了Android Studio和SDK,但运行后仍然出现Failed to load FirebaseOptions错误,设备显示白屏。以下是我的相关代码和报错日志:

初始化代码

void main() async{
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(const MyApp());
}

app级build.gradle

plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
    id "com.google.gms.google-services"
}

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

android {
    namespace "com.example.flutter_firebase"
    compileSdk flutter.compileSdkVersion
    ndkVersion flutter.ndkVersion

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        multiDexEnabled true
        applicationId "com.example.flutter_firebase"
        minSdkVersion flutter.minSdkVersion
        targetSdkVersion flutter.targetSdkVersion
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    buildTypes {
        release {
            signingConfig signingConfigs.debug
        }
    }
}

flutter {
    source '../..'
}

dependencies {
    implementation(platform("com.google.firebase:firebase-bom:32.8.1"))
    implementation("com.google.firebase:firebase-analytics")
    implementation 'com.android.support:multidex:1.0.3'

}

项目级build.gradle

buildscript {
    ext.kotlin_version = '1.9.23'

    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath ("com.google.gms:google-services:4.4.1")
        classpath ("com.google.firebase:firebase-appdistribution-gradle:4.2.0")
        classpath ("com.google.firebase:firebase-crashlytics-gradle:2.9.9")
        classpath ("com.google.firebase:firebase-crashlytics-gradle:2.9.9")
        classpath ("com.google.firebase:perf-plugin:1.4.2")
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.23"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(':app')
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

报错日志

Performing hot restart...
Syncing files to device 23076RN4BI...
Restarted application in 2,194ms.
E/flutter (28544): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: PlatformException(java.lang.Exception: Failed to load FirebaseOptions from resource. Check that you have defined values.xml correctly., Exception, Cause: null, Stacktrace: java.lang.Exception: Failed to load FirebaseOptions from resource. Check that you have defined values.xml correctly.
E/flutter (28544):  at io.flutter.plugins.firebase.core.FlutterFirebaseCorePlugin.lambda$optionsFromResource$4$io-flutter-plugins-firebase-core-FlutterFirebaseCorePlugin(FlutterFirebaseCorePlugin.java:207)
E/flutter (28544):  at io.flutter.plugins.firebase.core.FlutterFirebaseCorePlugin$$ExternalSyntheticLambda2.run(Unknown Source:4)
E/flutter (28544):  at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
E/flutter (28544):  at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:644)
E/flutter (28544):  at java.lang.Thread.run(Thread.java:1012)
E/flutter (28544): , null)
E/flutter (28544): #0      FirebaseCoreHostApi.optionsFromResource (package:firebase_core_platform_interface/src/pigeon/messages.pigeon.dart:242:7)
E/flutter (28544): <asynchronous suspension>
E/flutter (28544): #1      MethodChannelFirebase.initializeApp (package:firebase_core_platform_interface/src/method_channel/method_channel_firebase.dart:89:25)
E/flutter (28544): <asynchronous suspension>
E/flutter (28544): #2      Firebase.initializeApp (package:firebase_core/src/firebase.dart:43:31)
E/flutter (28544): <asynchronous suspension>
E/flutter (28544): #3      main (package:flutter_firebase/main.dart:6:3)
E/flutter (28544): <asynchronous suspension>
E/flutter (28544): 

解决步骤

  • 检查google-services.json文件:确保从Firebase控制台下载的google-services.json已正确放置在android/app目录下,且文件内的package_name与app级build.gradle中的applicationId完全一致(当前为com.example.flutter_firebase)。
  • 验证自动生成的values.xml:检查android/app/build/generated/res/google-services/debug/values/values.xml是否存在且包含Firebase配置参数(如google_api_key、firebase_database_url),若文件为空或不存在,说明插件未正确解析配置文件。
  • 清理缓存并重新构建:执行flutter clean && flutter pub get && cd android && ./gradlew clean && cd ..,之后在Android Studio中同步Gradle项目。
  • 手动传入FirebaseOptions:若自动配置失败,可在初始化时手动指定参数:
await Firebase.initializeApp(
  options: FirebaseOptions(
    apiKey: "你的API_KEY",
    appId: "你的APP_ID",
    messagingSenderId: "你的SENDER_ID",
    projectId: "你的PROJECT_ID",
    storageBucket: "你的STORAGE_BUCKET",
  ),
);

参数可从Firebase控制台项目设置或google-services.json中提取。

  • 检查依赖兼容性:确认com.google.gms:google-services版本与Firebase BOM版本兼容,若有问题可尝试升级google-services到最新稳定版。
  • 简化MultiDex配置:若minSdkVersion≥21,无需手动添加com.android.support:multidex依赖,系统会自动支持,可移除该依赖项。

内容的提问来源于stack exchange,提问作者Vishal Dubey

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.25 05:21:01