Flutter中FirebaseAuth登录/注册偶发无响应问题求助

问题现象 #

测试基于FirebaseAuth的Flutter注册功能时，点击注册按钮偶发无响应，有时能成功触发注册；VSCode带调试运行时功能完全正常，不带调试运行（release模式）下问题复现。

问题根源分析 #

1. Firebase初始化时序错误 #

原代码中，Firebase初始化被放在RegisterView的FutureBuilder中执行，且main函数未等待Firebase初始化完成就启动App。这会导致：

• 页面渲染时Firebase可能尚未完成初始化，此时点击按钮会触发无效请求；
• FutureBuilder在页面重建时会重复执行Firebase.initializeApp，导致Firebase状态混乱，尤其是在release模式下异步执行速度更快，时序问题被放大。

2. 无防重复点击处理 #

按钮未做防重复提交限制，用户快速多次点击会触发多重复注册请求，不仅浪费资源，还会导致异常叠加，表现为按钮无响应。

日志佐证 #

从运行日志可见，同一邮箱被多次触发注册请求，最终因邮箱已存在抛出异常，说明重复点击和初始化时序问题共同导致了无响应现象：

I/FirebaseAuth(19153): Creating user with example@gmail.com with empty reCAPTCHA token
I/FirebaseAuth(19153): Creating user with example@gmail.com with empty reCAPTCHA token
I/FirebaseAuth(19153): Creating user with example@gmail.com with empty reCAPTCHA token
E/RecaptchaCallWrapper(19153): Initial task failed for action RecaptchaAction(action=signUpPassword)with exception - The email address is already in use by another account.
I/flutter (19153): Email already exists

解决方案 #

1. 修正Firebase初始化时机 #

将Firebase初始化移至main函数，等待初始化完成后再启动App，确保全局仅初始化一次，且App启动时Firebase已就绪。

2. 添加防重复点击逻辑 #

新增_isLoading状态变量，控制按钮的可点击状态与加载提示，避免重复提交。

3. 完善异常反馈 #

除日志打印外，通过SnackBar给用户直观的错误提示，提升体验。

修改后的完整代码 #

import 'package:flutter/material.dart';
import "firebase_options.dart";
import "package:firebase_core/firebase_core.dart";
import "package:firebase_auth/firebase_auth.dart";
import "package:mynotes/views/login.dart";

// 修正：main函数等待Firebase初始化完成后再启动App
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(MaterialApp(
    title: 'Flutter Demo',
    theme: ThemeData(
      colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
      useMaterial3: true,
    ),
    home: const RegisterView(),
  ));
}

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

  @override
  State<RegisterView> createState() => _RegisterViewState();
}

class _RegisterViewState extends State<RegisterView> {
  late final TextEditingController _email;
  late final TextEditingController _password;
  // 新增：防重复点击状态
  bool _isLoading = false;

  @override
  void initState() {
    _email = TextEditingController();
    _password = TextEditingController();
    super.initState();
  }

  @override
  void dispose() {
    _email.dispose();
    _password.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("Register"),
        foregroundColor: Colors.white,
        backgroundColor: Colors.blue,
      ),
      // 移除原FutureBuilder，Firebase已在main中初始化完成
      body: Column(
        children: [
          TextField(
            controller: _email,
            enableSuggestions: false,
            autocorrect: false,
            keyboardType: TextInputType.emailAddress,
            decoration: const InputDecoration(
                hintText: "Enter your email here"),
          ),
          TextField(
            controller: _password,
            obscureText: true,
            enableSuggestions: false,
            autocorrect: false,
            decoration: const InputDecoration(
                hintText: "Enter your password here"),
          ),
          TextButton(
            // 修正：根据_isLoading控制按钮可点击状态
            onPressed: _isLoading ? null : () async {
              setState(() {
                _isLoading = true;
              });
              final String email = _email.text;
              final String password = _password.text;

              try {
                final UserCredential userCredential = await FirebaseAuth
                    .instance
                    .createUserWithEmailAndPassword(
                        email: email, password: password);
                print(userCredential);
                // 注册成功后的逻辑，比如跳转登录页
                if (mounted) {
                  Navigator.of(context).pushReplacement(
                    MaterialPageRoute(builder: (context) => const LoginView()),
                  );
                }
              } on FirebaseAuthException catch (e) {
                String errorMessage = "Registration failed";
                if (e.code == "weak-password") {
                  errorMessage = "Weak password";
                } else if (e.code == "email-already-in-use") {
                  errorMessage = "Email already exists";
                } else if (e.code == "invalid-email") {
                  errorMessage = "Invalid email";
                }
                // 显示错误提示
                if (mounted) {
                  ScaffoldMessenger.of(context).showSnackBar(
                    SnackBar(content: Text(errorMessage)),
                  );
                }
                print(errorMessage);
              } finally {
                // 无论成功失败，恢复按钮状态
                if (mounted) {
                  setState(() {
                    _isLoading = false;
                  });
                }
              }
            },
            child: _isLoading 
                ? const CircularProgressIndicator(color: Colors.white) 
                : const Text("Register"),
          ),
        ],
      ),
    );
  }
}

关键修改点说明 #

• main函数：新增async/await等待Firebase初始化完成，确保App启动时Firebase已就绪；
• 防重复点击：通过_isLoading变量控制按钮可点击状态，点击后显示加载指示器，请求完成后恢复；
• 移除FutureBuilder：Firebase已全局初始化，无需在页面中重复处理；
• 异常反馈：新增SnackBar给用户显示错误信息，同时使用mounted判断避免上下文已销毁时的状态更新错误。

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