Flutter Firebase认证报错：app/invalid-app-argument 求助

之前正常运行的Flutter Firebase邮箱/密码认证功能，今日突然无法完成注册和登录。已尝试flutter clean重新运行、回滚至历史正常版本，问题依旧。触发的错误信息：

FirebaseError: Firebase: firebase.auth() takes either no argument or a Firebase App instance. (app/invalid-app-argument)

运行环境为localhost:5000，已在Google Cloud API与服务中配置该域名的访问权限。

相关代码 #

1. 登录按钮逻辑 #

ElevatedButton(
  style: buttonStyle,
  onPressed: () async {
    if (_formKey.currentState!.validate()) {
      try {
        final credential = await FirebaseAuth.instance
            .signInWithEmailAndPassword(
          email: _emailController.text,
          password: _passwordController.text,
        ).then((_) {
          Navigator.pushReplacementNamed(context, '/timeline');
        });
      } on FirebaseAuthException catch (e) {
        if (e.code == "invalid-email") {
          showDialog(
            context: context,
            builder: (context) => ErrorMessage("Invalid email"),
          );
        } else if (e.code == 'user-not-found') {
          showDialog(
            context: context,
            builder: (context) => ErrorMessageWithRoute(
              "Email not registered",
              "/signup",
            ),
          );
        } else if (e.code == 'wrong-password') {
          showDialog(
            context: context,
            builder: (context) => ErrorMessage("Wrong password"),
          );
        }
      } catch (e) {
        showDialog(
          context: context,
          builder: (context) => ErrorMessage(
            "There was an error please contact us or try again ${e}",
          ),
        );
      }
    }
  },
  child: const Text("Sign in"),
);

2. Firebase配置文件（敏感值已隐去） #

// File generated by FlutterFire CLI.
// ignore_for_file: lines_longer_than_80_chars, avoid_classes_with_only_static_members
import 'package:firebase_core/firebase_core.dart' show FirebaseOptions;
import 'package:flutter/foundation.dart'
    show defaultTargetPlatform, kIsWeb, TargetPlatform;

/// Default [FirebaseOptions] for use with your Firebase apps.
///
/// Example:
/// ```dart
/// import 'firebase_options.dart';
/// // ...
/// await Firebase.initializeApp(
///   options: DefaultFirebaseOptions.currentPlatform,
/// );
/// ```
class DefaultFirebaseOptions {
  static FirebaseOptions get currentPlatform {
    if (kIsWeb) {
      return web;
    }
    switch (defaultTargetPlatform) {
      case TargetPlatform.android:
        return android;
      case TargetPlatform.iOS:
        return ios;
      case TargetPlatform.macOS:
        throw UnsupportedError(
          'DefaultFirebaseOptions have not been configured for macos - '
          'you can reconfigure this by running the FlutterFire CLI again.',
        );
      case TargetPlatform.windows:
        throw UnsupportedError(
          'DefaultFirebaseOptions have not been configured for windows - '
          'you can reconfigure this by running the FlutterFire CLI again.',
        );
      case TargetPlatform.linux:
        throw UnsupportedError(
          'DefaultFirebaseOptions have not been configured for linux - '
          'you can reconfigure this by running the FlutterFire CLI again.',
        );
      default:
        throw UnsupportedError(
          'DefaultFirebaseOptions are not supported for this platform.',
        );
    }
  }

  static const FirebaseOptions web = FirebaseOptions(
    apiKey: ,
    appId: ,
    messagingSenderId: ,
    projectId: ,
    authDomain: ,
    storageBucket: ,
    measurementId: ,
  );

  static const FirebaseOptions android = FirebaseOptions(
    apiKey: ,
    appId: ,
    messagingSenderId: ,
    projectId: ,
    storageBucket: ,
  );

  static const FirebaseOptions ios = FirebaseOptions(
    apiKey: ,
    appId: ,
    messagingSenderId: ,
    projectId: ,
    storageBucket: ,
    androidClientId:
        ,
    iosClientId:
        ,
    iosBundleId: ,
  );
}

3. main.dart初始化代码 #

// Flutter widgets
import 'package:flutter/material.dart';

// Pages
import 'package:fbla_lettering_point_app/Pages/User/timeline.dart';
import 'package:fbla_lettering_point_app/Pages/signup.dart';
import 'package:fbla_lettering_point_app/Pages/login.dart';
import 'package:fbla_lettering_point_app/Pages/User/profile.dart';
import 'package:fbla_lettering_point_app/Pages/verify_email_page.dart';
import 'package:fbla_lettering_point_app/Pages/Admin/admin_timeline.dart';

// DB/Auth
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
import 'package:firebase_auth/firebase_auth.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'FBLA Lettering Points',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      routes: <String, WidgetBuilder>{
        '/signin': (context) => const SignInPage(),
        '/signup': (context) => const SignUpPage(),
        '/timeline': (context) => const Timeline(),
        '/profile': (context) => const Profile(),
        '/verify': (context) => const VerifyEmailPage(),
      },
      home: const SignInPage(),
    );
  }
}

排查与解决方案 #

1. 补全Web平台Firebase配置 #

错误核心原因是Web平台的Firebase初始化参数不完整。检查DefaultFirebaseOptions.web中的所有字段，确保apiKey、authDomain、projectId等所有参数都填入Firebase控制台Web应用的对应值，不能留空。

2. 验证Firebase初始化状态 #

在main函数中添加初始化日志，确认Firebase是否成功初始化，避免Auth服务提前调用：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  try {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    print("Firebase初始化成功");
  } catch (e) {
    print("Firebase初始化失败: $e");
  }
  runApp(const MyApp());
}

3. 清除浏览器缓存 #

Web平台下，浏览器可能缓存旧的配置数据。按Ctrl+Shift+R强制刷新页面，或手动清除localhost:5000的站点缓存后重新运行。

4. 重新生成Firebase配置文件 #

使用FlutterFire CLI重新生成配置文件，确保平台配置正确：

flutterfire configure

选择对应Firebase项目和Web平台，覆盖原有配置文件。

5. 统一Firebase依赖版本 #

检查pubspec.yaml中firebase_core和firebase_auth的版本，确保两者兼容。建议升级到最新稳定版：

firebase_core: ^2.24.2
firebase_auth: ^4.16.0

执行flutter pub get更新依赖后重新运行项目。

6. 确认Firebase服务状态 #

• 登录Firebase控制台，进入Auth -> Sign-in method，确认邮箱/密码登录方式已启用；
• 在Google Cloud控制台中，检查Identity Toolkit API是否处于启用状态。

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