Flutter中如何存储并全局访问已登录用户的Firebase/Firestore资料数据

一、先把注册流程做对：绑定Auth与Firestore用户数据 #

注册时必须把Firebase Auth生成的uid作为Firestore中用户文档的ID，这样能通过Auth的当前用户ID快速定位到Firestore里的完整信息。示例代码：

Future<void> registerUser(String email, String password, String firstName, String lastName) async {
  try {
    // 1. 先创建Firebase Auth账号
    UserCredential credential = await FirebaseAuth.instance.createUserWithEmailAndPassword(
      email: email,
      password: password,
    );
    
    // 2. 把额外信息存入Firestore，用Auth的uid作为文档ID
    if (credential.user != null) {
      await FirebaseFirestore.instance.collection('users').doc(credential.user!.uid).set({
        'email': email,
        'firstName': firstName,
        'lastName': lastName,
        'createdAt': FieldValue.serverTimestamp(),
      });
    }
  } catch (e) {
    // 处理注册错误
    print('注册失败: $e');
  }
}

二、全局访问用户信息的几种方案 #

方案1：直接从Firestore实时获取（最可靠） #

每次需要用户信息时，通过当前Auth用户的uid去Firestore拉取，还能监听数据变化（比如用户修改个人信息时自动更新）：

// 获取当前用户完整信息
Future<Map<String, dynamic>?> getCurrentUserInfo() async {
  User? currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) return null;
  
  DocumentSnapshot doc = await FirebaseFirestore.instance.collection('users').doc(currentUser.uid).get();
  return doc.data() as Map<String, dynamic>?;
}

// 监听用户信息变化（适合需要实时更新的场景）
Stream<Map<String, dynamic>?> listenToCurrentUserInfo() {
  User? currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) return Stream.value(null);
  
  return FirebaseFirestore.instance.collection('users').doc(currentUser.uid)
      .snapshots()
      .map((doc) => doc.data() as Map<String, dynamic>?);
}

方案2：用状态管理缓存用户信息（避免重复请求） #

如果不想每次都去Firestore查，可以用状态管理工具（比如Provider、Riverpod）把用户信息存在内存里，全局可访问：

以Provider为例，先创建一个用户状态类：

class UserProvider extends ChangeNotifier {
  Map<String, dynamic>? _userInfo;
  
  Map<String, dynamic>? get userInfo => _userInfo;
  
  Future<void> fetchUserInfo() async {
    User? currentUser = FirebaseAuth.instance.currentUser;
    if (currentUser == null) return;
    
    DocumentSnapshot doc = await FirebaseFirestore.instance.collection('users').doc(currentUser.uid).get();
    _userInfo = doc.data() as Map<String, dynamic>?;
    notifyListeners();
  }
  
  // 登出时清空缓存
  void clearUserInfo() {
    _userInfo = null;
    notifyListeners();
  }
}

然后在main.dart中初始化Provider：

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (context) => UserProvider(),
      child: const MyApp(),
    ),
  );
}

之后在任意页面获取用户信息：

final userProvider = Provider.of<UserProvider>(context);
// 页面初始化时拉取数据
@override
void initState() {
  super.initState();
  userProvider.fetchUserInfo();
}

// 使用信息
Text(userProvider.userInfo?['firstName'] ?? '未知');

方案3：修复shared_preferences的通道错误 #

你遇到的PlatformException(channel-error)通常是因为插件初始化时机不对，或者依赖版本问题，解决步骤：

1. 确保在main函数中先初始化Firebase和shared_preferences：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await SharedPreferences.getInstance(); // 提前初始化
  runApp(const MyApp());
}

2. 检查pubspec.yaml中shared_preferences的版本，更新到最新稳定版，然后执行：

flutter clean
flutter pub get

3. 重启应用（热重载可能不生效，需要完全重启）

如果还是不行，尝试删除ios/Podfile.lock和android/.gradle文件夹，重新构建项目。

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