Firebase authChanges触发两次：StreamBuilder重复渲染问题排查

你的StreamBuilder被调用两次导致子组件重复渲染，主要有两个常见原因，对应解决方案如下：

可能原因1：Firebase Auth流发送重复的用户快照 #

Firebase的authStateChanges()流在初始化阶段，可能会连续发送两次相同的用户状态快照（比如先返回初始的null，随后再次确认并发送相同的null或已登录用户对象），这会触发StreamBuilder的builder方法两次。

可能原因2：ThemeProvider的Consumer导致MaterialApp重建，StreamBuilder重新订阅流 #

你的MaterialApp包裹在Consumer<ThemeProvider>内部，当ThemeProvider的状态变化（包括初始化时的首次通知），会触发MaterialApp重建，进而导致内部的StreamBuilder重新订阅authChanges流。而Firebase的authStateChanges()流每次被订阅时，都会主动发送当前的用户状态，这就会再次触发builder执行。

解决方案 #

方案1：给Auth流添加去重过滤 #

在初始化authChanges时，使用distinct()操作符过滤掉重复的用户快照，只有当用户的唯一标识（uid）变化时才触发事件：

@override
void initState() {
  authChanges = fb_auth.FirebaseAuth.instance.authStateChanges()
      // 仅当用户uid变化时才传递事件
      .distinct((prevUser, currUser) => prevUser?.uid == currUser?.uid);
  super.initState();
}

方案2：将用户状态管理移到组件state中，避免StreamBuilder重复订阅 #

手动监听Auth流并更新组件状态，直接在build方法中根据状态返回页面，彻底避免StreamBuilder因组件重建而重复触发：

class _MyAppState extends State<MyApp> {
  fb_auth.User? _currentUser;

  @override
  void initState() {
    super.initState();
    // 监听Auth状态变化，仅在用户实际变更时更新状态
    fb_auth.FirebaseAuth.instance.authStateChanges()
        .distinct((prev, curr) => prev?.uid == curr?.uid)
        .listen((user) {
          setState(() {
            _currentUser = user;
          });
        });
  }

  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onTap: () {
        FocusScopeNode currentFocus = FocusScope.of(context);
        if (!currentFocus.hasPrimaryFocus &&
            currentFocus.focusedChild != null) {
          FocusManager.instance.primaryFocus!.unfocus();
        }
      },
      child: Consumer<ThemeProvider>(builder: (context, provider, _) {
        return MaterialApp(
          debugShowCheckedModeBanner: kDebugMode ? true : false,
          title: 'MY app',
          themeMode: provider.themeMode,
          home: _currentUser == null ? Login() : BottomNavBar(),
        );
      }),
    );
  }
}

额外检查点 #

确认你的ThemeProvider是否在初始化时多次调用了notifyListeners()，这也会导致Consumer频繁重建MaterialApp，间接引发StreamBuilder重复触发。

内容的提问来源于stack exchange，提问作者Carl.G