如何用Future和FutureBuilder正确计算Firebase查询商品总数？解决计数异常

问题根源 #

• 全局计数器累加：你使用了全局counter变量，每次查询都在原有值上累加，未重置初始值，导致数值持续变大。
• 错误混用流与Future：authStateChanges()是流监听（持续触发回调），但你的get_cart_no()是一次性的Future方法，不该用listen，应直接获取当前用户状态。
• FutureBuilder用法错误：直接在future参数中调用get_cart_no()会导致每次组件重建都重新执行查询；且没有利用Future返回的结果，反而依赖全局变量。

修正后的代码实现 #

1. 重构统计总数的Future方法

取消全局计数器，在方法内独立计算总数并返回，避免setState干扰：

Future<int> getCartItemCount() async {
  // 获取当前登录用户
  final user = FirebaseAuth.instance.currentUser;
  if (user == null) return 0;

  // 查询购物车内的商品
  final snapshot = await FirebaseFirestore.instance
      .collection('items')
      .where('in_cart', isEqualTo: "yes")
      .where('uid', isEqualTo: user.uid)
      .get();

  // 累加所有商品的数量
  int total = 0;
  for (final doc in snapshot.docs) {
    total += doc['item_q'] as int;
  }
  return total;
}

2. 正确使用FutureBuilder

将Future实例存为成员变量，避免重复执行查询；直接使用snapshot返回的数据：

class YourCartWidget extends StatefulWidget {
  @override
  _YourCartWidgetState createState() => _YourCartWidgetState();
}

class _YourCartWidgetState extends State<YourCartWidget> {
  // 提前初始化Future，避免每次build重新发起请求
  late final Future<int> _cartItemCountFuture;

  @override
  void initState() {
    super.initState();
    _cartItemCountFuture = getCartItemCount();
  }

  Future<int> getCartItemCount() async {
    // 上面的方法代码
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<int>(
      future: _cartItemCountFuture,
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator(color: Colors.grey));
        } else if (snapshot.hasError) {
          return const Text('加载失败');
        } else {
          // 直接使用Future返回的结果，无需全局变量
          return Text(snapshot.data.toString());
        }
      },
    );
  }
}

额外优化建议 #

• 如果需要实时监听用户登录状态或购物车数据变化，建议用StreamBuilder替代FutureBuilder——Future是一次性请求，Stream可持续监听数据更新。
• 永远不要在FutureBuilder的future参数中直接调用方法，将Future存为成员变量能避免不必要的重复请求。

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