Flutter中VerifyEmailView无法正常显示问题求助

开发注册页面时，期望用户注册完成后展示带有验证邮件发送链接的VerifyEmailView，但当user.emailVerified为false时，该视图并未正常显示。相关代码如下：

import 'package:firebase_auth/firebase_auth.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';
import 'package:nxtreame/firebase_options.dart';
import 'package:nxtreame/views/login_view.dart';
import 'package:nxtreame/views/register_view.dart';
import 'package:nxtreame/views/verify_email_view.dart';


void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(
    MaterialApp(
      title: 'Nxtream demo',
      theme: ThemeData(
        
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const HomePage(),
      routes: {
        '/login':(context) => const LoginView(),
        '/register':(context) => const RegisterView()
      },
    ),
  );
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
    Widget build(BuildContext context) {
      return FutureBuilder(
          future: Firebase.initializeApp(
                      options: DefaultFirebaseOptions.currentPlatform,
                    ),

          builder: (context, snapshot) { 
            switch (snapshot.connectionState){
              case ConnectionState.done:
                final user  = FirebaseAuth.instance.currentUser;
                if (user != null){
                  if(user.emailVerified){
                    print('Email is verified');
                  }else{
                    return const VerifyEmailView();
                  }
                } else {
                  return const LoginView();
                }
                return const Text('Done');
              default: 
                return const CircularProgressIndicator();
            }  
          },
        );
    }
}

修复方案 #

1. 刷新Firebase用户缓存状态 #

FirebaseAuth.instance.currentUser返回的是本地缓存数据，emailVerified状态可能未实时更新。需要主动调用user.reload()获取最新状态：

修改HomePage代码，嵌套FutureBuilder处理用户状态刷新：

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  Future<User?> _refreshUserStatus() async {
    final user = FirebaseAuth.instance.currentUser;
    if (user != null) {
      // 刷新用户信息，同步最新验证状态
      await user.reload();
      // 重新获取用户对象（reload不会更新原对象）
      return FirebaseAuth.instance.currentUser;
    }
    return null;
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform,
      ),
      builder: (context, snapshot) {
        switch (snapshot.connectionState) {
          case ConnectionState.done:
            return FutureBuilder(
              future: _refreshUserStatus(),
              builder: (context, userSnapshot) {
                if (userSnapshot.connectionState == ConnectionState.done) {
                  final user = userSnapshot.data;
                  if (user != null) {
                    if (user.emailVerified) {
                      print('Email is verified');
                      // 替换为你的已验证主页
                      return const Scaffold(body: Center(child: Text('Email Verified')));
                    } else {
                      return const VerifyEmailView();
                    }
                  } else {
                    return const LoginView();
                  }
                } else {
                  return const CircularProgressIndicator();
                }
              },
            );
          default:
            return const CircularProgressIndicator();
        }
      },
    );
  }
}

2. 注册完成后触发页面导航 #

在RegisterView的注册成功逻辑中，添加导航操作，确保触发HomePage的状态检查：

// 注册成功后发送验证邮件
await FirebaseAuth.instance.currentUser?.sendEmailVerification();
// 替换当前页面为HomePage，避免返回注册页
Navigator.of(context).pushReplacementNamed('/');

3. 检查VerifyEmailView自身代码 #

确认VerifyEmailView的build方法无异常，能正常返回Widget，例如是否存在空指针、布局错误等导致视图无法渲染的问题。

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