Flutter中FirebaseAuth.instance报错：getter 'instance'未定义

问题描述 #

在Flutter项目中集成Firebase Auth时遇到以下错误：

The getter 'instance' isn't defined for the type 'FirebaseAuth'.

操作流程：

1. 通过CLI安装依赖：flutter pub add firebase_auth
2. 在signup.dart中编写代码：

import 'package:firebase_auth/firebase_auth.dart';
final FirebaseAuth _auth = FirebaseAuth.instance;

此时触发上述错误，已确认FirebaseAuth.instance未被弃用，项目pubspec.yaml中的核心依赖配置如下：

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2
  firebase_core: ^2.15.0
  firebase_auth: ^4.7.2

排查解决方案 #

1. 确认Firebase Core已正确初始化

Firebase Auth依赖Firebase Core，必须在使用Auth前完成初始化。在main.dart中添加初始化代码：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart'; // 该文件由Firebase CLI生成，若无则需先执行firebase init

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

如果没有firebase_options.dart，需要通过Firebase CLI初始化项目（运行firebase init），或手动传入平台专属的初始化参数。

2. 清理依赖并重新加载

执行以下命令清理项目缓存，重新获取依赖：

flutter clean
flutter pub get

完成后重启IDE/编辑器，避免依赖未正确加载导致的符号识别问题。

3. 升级依赖到兼容版本

虽然当前版本理论上兼容，但尝试升级到最新稳定版：

flutter pub upgrade firebase_core firebase_auth

升级后再次执行flutter pub get，并重启项目测试。

4. 检查导入语句是否正确

确保signup.dart中的导入没有拼写错误，且未导入本地自定义的同名文件（避免命名冲突）：

import 'package:firebase_auth/firebase_auth.dart';

5. 清除IDE缓存

如果使用Android Studio或VS Code，尝试清除IDE缓存：

• Android Studio：File -> Invalidate Caches... -> Invalidate and Restart
• VS Code：打开命令面板（Ctrl+Shift+P），选择Developer: Reload Window

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