Flutter中Firebase Auth创建用户异常及启动时用户状态校验问题

我在用Firebase Auth创建用户时碰到个奇怪问题：用户用邮箱密码成功注册后，弹出自定义对话框，点确定后会自动跳转到登录页还报错。创建用户的代码如下：

UserCredential credential = await _auth
    .createUserWithEmailAndPassword(email: email, password: password);

我发现移除用户状态监听后问题就解决了，但我需要在APP启动时校验用户是否已登录且邮箱已验证，该怎么实现？启动页相关代码如下：

@override
Widget build(BuildContext context) {
  return GetMaterialApp(
      title: 'where to go',
      debugShowCheckedModeBanner: false,
      translations: Messages(),
      home: const SplashScreen());
}

class SplashScreen extends StatefulWidget {
  const SplashScreen({super.key});

  @override
  State<SplashScreen> createState() => _SplashScreenState();
}

class _SplashScreenState extends State<SplashScreen> {
  Timer? timer;

  _SplashScreenState() {
    timer = Timer(const Duration(seconds: 6), () async {
      setState(() {
        FirebaseAuth.instance.authStateChanges().listen((User? user) {
          if (user != null && user.emailVerified) {
            Get.put(UserController());
            Get.off(() => const HomePage());
          } else {
            Get.off(() => const Login());
          }
        });
      });
    });
  }

问题原因 #

当前启动页代码有两个核心问题：

• 在Timer回调里直接监听authStateChanges()，这个监听是持续生效的。用户注册成功后Auth状态发生变化（从无用户到有用户），监听会被触发，但刚注册的用户邮箱未验证，因此执行跳转登录页的逻辑。
• 把监听放在setState()里完全多余，authStateChanges()本身是流，不需要通过setState触发UI更新。

解决方案 #

要实现启动页一次性校验用户状态，同时避免后续Auth状态变化干扰注册流程，需要：

1. 启动页只做单次校验，不持续监听Auth状态流
2. 注册后的状态逻辑单独处理，和启动页初始化校验分离

修改后的启动页代码 #

@override
Widget build(BuildContext context) {
  return GetMaterialApp(
      title: 'where to go',
      debugShowCheckedModeBanner: false,
      translations: Messages(),
      home: const SplashScreen());
}

class SplashScreen extends StatefulWidget {
  const SplashScreen({super.key});

  @override
  State<SplashScreen> createState() => _SplashScreenState();
}

class _SplashScreenState extends State<SplashScreen> {
  Timer? timer;

  @override
  void initState() {
    super.initState();
    timer = Timer(const Duration(seconds: 6), () async {
      // 单次获取当前用户状态，不监听后续变化
      User? currentUser = FirebaseAuth.instance.currentUser;
      if (currentUser != null && currentUser.emailVerified) {
        Get.put(UserController());
        Get.off(() => const HomePage());
      } else {
        Get.off(() => const Login());
      }
    });
  }

  @override
  void dispose() {
    timer?.cancel();
    super.dispose();
  }
}

注册流程的补充处理 #

注册成功后手动处理后续逻辑（比如发送验证邮件、引导用户验证），不依赖启动页监听：

// 注册逻辑示例
try {
  UserCredential credential = await _auth
      .createUserWithEmailAndPassword(email: email, password: password);
  
  // 发送邮箱验证邮件
  await credential.user?.sendEmailVerification();
  
  // 弹出自定义对话框提示用户验证邮箱
  showDialog(
    context: context,
    builder: (context) => AlertDialog(
      title: const Text('注册成功'),
      content: const Text('请查收邮件验证你的邮箱'),
      actions: [
        TextButton(
          onPressed: () {
            Navigator.of(context).pop();
            // 点击确定后可手动跳转到登录页，或留在当前页面引导验证
            Get.off(() => const Login());
          },
          child: const Text('确定'),
        )
      ],
    ),
  );
} catch (e) {
  // 处理注册错误
  print(e);
}

全局状态监听的正确用法（可选） #

如果需要在APP运行中监听用户状态变化（比如退出登录、验证邮箱后自动跳转），可在首页或根组件中添加监听，而非启动页：

// 在HomePage的initState中添加监听
StreamSubscription? _authStateListener;

@override
void initState() {
  super.initState();
  _authStateListener = FirebaseAuth.instance.authStateChanges().listen((User? user) {
    if (user == null) {
      // 用户退出，跳转到登录页
      Get.off(() => const Login());
    } else if (!user.emailVerified) {
      // 用户未验证邮箱，弹出提示
      showEmailVerificationPrompt();
    }
  });
}

@override
void dispose() {
  _authStateListener?.cancel();
  super.dispose();
}

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