Flutter集成Firebase邮箱验证Gmail收不到邮件问题

问题现象 #

使用Firebase实现邮箱验证功能时，发往sample@gmail.com这类Gmail地址的验证邮件无法正常送达，temp-mail等临时邮箱地址可正常接收验证邮件，相关验证页面实现代码如下：

class VerifyEmailPage extends StatefulWidget {
  const VerifyEmailPage({Key? key}) : super(key: key);

  @override
  State<VerifyEmailPage> createState() => _VerifyEmailPageState();
}

class _VerifyEmailPageState extends State<VerifyEmailPage> {
  bool isEmailVerified = true;
  Timer? timer;

  @override
  void initState() {
    super.initState();

    // 需提前完成用户创建
    isEmailVerified = FirebaseAuth.instance.currentUser!.emailVerified;
    if (!isEmailVerified) {
      sendVerificationEmail();
      timer = Timer.periodic(const Duration(seconds: 3), (timer) {
        checkEmailVerified();
      });
    }
  }

  Future checkEmailVerified() async {
    FirebaseAuth.instance.currentUser!.reload();
    setState(() {
      isEmailVerified = FirebaseAuth.instance.currentUser!.emailVerified;
    });
    if (isEmailVerified) timer?.cancel();
  }

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

  Future sendVerificationEmail() async {
    try {
      final user = FirebaseAuth.instance.currentUser;
      await user
          ?.sendEmailVerification()
          .then((value) => print("Verification sent! to ${user.email}"));
    } on Exception catch (e) {
      showErrorAlert(context, e.toString());
    }
  }

  AuthService _auth = AuthService();

  @override
  Widget build(BuildContext context) => isEmailVerified
      ? HomeScreen(selectedIndex: 0)
      : Scaffold(
          appBar: AppBar(
            title: Text("Verify your email"),
            centerTitle: true,
            elevation: 0,
            backgroundColor: kPrimaryColor,
            leading: IconButton(
              icon: Icon(Icons.arrow_back),
              onPressed: () async {
                await _auth.signOut();
              },
            ),
          ),
          body: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: const [
              Text("Verification email is sent to you!!",
                  style: TextStyle(fontSize: 20.0),
                  textAlign: TextAlign.center),
            ],
          ));
}

故障原因 #

• 核心原因是Firebase默认使用公共共享发信域名发送验证邮件，这类域名被大量开发者共用，发信信誉低，Gmail反垃圾策略会直接拦截或归类到垃圾/推广文件夹，而临时邮箱反垃圾规则宽松，所以可以正常接收。
• 现有代码逻辑存在缺陷：页面初始化时自动触发发信，无发送频率限制，叠加3秒一次的高频轮询，短时间重复请求会进一步降低发信信誉，触发Gmail拦截规则。
• 若Firebase项目仍处于测试阶段，未配置自定义域名时发信配额有限，发往Gmail这类主流邮箱的投递优先级低，容易出现丢件。

解决方法 #

• 根本解决方式：在Firebase控制台进入Authentication-Templates-发件人配置页面，绑定自有域名，按照指引配置SPF、DKIM、DMARC域名解析记录，提升发信信誉，配置完成后Gmail会正常投递验证邮件。
• 临时排查阶段，先检查Gmail账号的「垃圾邮件」「推广邮件」文件夹，多数情况不是邮件未送达，是被自动归类到非收件箱目录。
• 优化现有代码逻辑：
  1. 移除initState中自动触发发信的逻辑，增加手动「重新发送验证邮件」按钮，添加60秒发信冷却，避免短时间重复发信触发反垃圾规则，优化后的发信逻辑参考：

  // 新增发信冷却状态标记
  bool canResendEmail = true;
  
  Future sendVerificationEmail() async {
    if (!canResendEmail) return;
    try {
      final user = FirebaseAuth.instance.currentUser;
      await user?.sendEmailVerification();
      setState(() => canResendEmail = false);
      // 60秒冷却期后允许再次发送
      await Future.delayed(const Duration(seconds: 60));
      if (mounted) setState(() => canResendEmail = true);
    } on Exception catch (e) {
      if (mounted) showErrorAlert(context, e.toString());
    }
  }
  

  2. 将邮箱验证状态的轮询间隔从3秒调整为10秒以上，减少无效API请求，避免触发Firebase请求频率限制。
• 检查Firebase控制台的邮件模板配置，避免使用诱导点击类的敏感文案，降低被判定为垃圾邮件的概率。

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