Flutter中如何从Firebase获取当前用户的uid并作为全局变量使用

前置要求 #

已完成Firebase基础配置：

• 项目中已集成firebase_auth插件
• 已在main函数中完成Firebase.initializeApp()初始化操作
• 已实现基础的用户登录/登出逻辑

方案1：静态全局类（小型项目快速实现） #

无需状态管理依赖，适合不需要响应式更新的简单场景

1. 定义全局静态存储类

// 可放在lib/global/constant.dart路径下
class GlobalConstants {
  // 存储当前登录用户UID
  static String? currentLoginUid;
}

2. 监听Firebase登录状态同步UID
   建议在App初始化阶段就启动监听，保证UID实时同步：

FirebaseAuth.instance.authStateChanges().listen((User? user) {
  if (user != null) {
    GlobalConstants.currentLoginUid = user.uid;
  } else {
    // 用户登出时清空UID
    GlobalConstants.currentLoginUid = null;
  }
});

3. 全页面调用
   任意位置直接读取即可，使用前注意判空：

String? uid = GlobalConstants.currentLoginUid;

注意：该方案无状态监听能力，UID变更时不会主动触发页面刷新，仅适合不需要跟随登录状态自动更新UI的场景

方案2：Provider状态管理（主流推荐） #

支持响应式更新，UID变更时自动刷新关联页面，适合绝大多数项目

1. 首先在pubspec.yaml中添加provider依赖
2. 创建用户状态管理类

// lib/providers/user_auth_provider.dart
import 'package:firebase_auth/firebase_auth.dart';
import 'package:flutter/foundation.dart';

class UserAuthProvider with ChangeNotifier {
  String? _currentUid;
  // 对外暴露只读的UID
  String? get currentUid => _currentUid;

  UserAuthProvider() {
    // 初始化时自动监听登录状态变化
    _listenAuthState();
  }

  void _listenAuthState() {
    FirebaseAuth.instance.authStateChanges().listen((User? user) {
      _currentUid = user?.uid;
      // 通知所有监听该状态的组件刷新
      notifyListeners();
    });
  }

  // 登出时手动清空状态的扩展方法
  void clearUserState() {
    _currentUid = null;
    notifyListeners();
  }
}

3. 全局注册Provider
   修改main函数完成注册：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(
    ChangeNotifierProvider(
      create: (context) => UserAuthProvider(),
      child: const MyApp(),
    ),
  );
}

4. 页面中调用UID

• 需要响应式刷新UI的场景：

// 放在build方法内，UID变化时自动触发build刷新
final uid = context.watch<UserAuthProvider>().currentUid;

• 仅需一次性读取UID的场景：

// 可放在build方法外，仅读取当前最新状态，不会触发自动刷新
final uid = context.read<UserAuthProvider>().currentUid;

通用注意事项 #

• 所有调用UID的位置必须做空判断，避免用户未登录时空指针报错
• 不要在组件的initState中调用context.watch，会触发语法异常

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