Flutter StreamBuilder读取FirebaseFirestore购物车快照数据不一致问题排查

问题现象 #

我在获取购物车商品时，快照数据出现不一致问题：

• 当购物车内只有1件商品时，返回的格式是正确的，结果如下：
  {1111111111111: 1, PriceSmart: 540.0}
• 当购物车内有2件商品，且第二件商品的卖家同样是PriceSmart时，程序报错，此时返回的结果如下：
  {1111111111111: 1, PriceSmart: 300.0, 5555555555555: 1}
• 预期正确返回结果为：
  {1111111111111: 1, PriceSmart: 540.0, 5555555555555: 1, PriceSmart: 300.0}

相关数据结构 #

Firebase中两件购物车商品的存储结构如下：

• 第一件购物车商品：
  
• 第二件购物车商品：
  

核心问题 #

程序会自动合并相同的卖家（PriceSmart）字段，需要返回每件购物车商品的完整数据，否则只要购物车内出现多个同一卖家的商品时就会报错。现需要检查如下Stream实现逻辑的问题：

class PriceUpdaterWidget extends StatefulWidget {
  const PriceUpdaterWidget({
    Key? key,
    required this.loginService,
    required this.code,
    required this.itemSubCategory,
  }) : super(key: key);
  final LoginService loginService;
  final String? code;
  final SubCategory? itemSubCategory;

  _PriceUpdaterWidgetState createState() => _PriceUpdaterWidgetState();
}

class _PriceUpdaterWidgetState extends State<PriceUpdaterWidget> {
  @override
  Widget build(BuildContext context) {
    CategorySelectionService catSelection =
        Provider.of<CategorySelectionService>(context, listen: false);

    Stream<DocumentSnapshot> priceDocStream = FirebaseFirestore.instance
        .collection('shoppers')
        .doc(widget.loginService.loggedInUserModel!.uid)
        .collection("cartItems")
        .doc(widget.code)
        .snapshots();
    return StreamBuilder<DocumentSnapshot>(
        stream: priceDocStream,
        builder:
            (BuildContext context, AsyncSnapshot<DocumentSnapshot> snapshot) {
          
          SellerNameService isSellerName =
              Provider.of<SellerNameService>(context, listen: false);

          var sellerName = isSellerName.isSellerName;

          if (snapshot.data != null) {
            return Text(
              snapshot.data![sellerName].toStringAsFixed(2),
              textAlign: TextAlign.center,
            );
          } else {
            return Text('No Data');
          }
        });
  }
}

根本原因 #

你预期返回的结果本身不符合JSON/Map的语法规范：同一个Map对象中不允许出现重复的key，Firebase的DocumentSnapshot会把文档数据解析为Map结构，所以重复的卖家名称作为key时自然会被覆盖合并，这不是Stream的问题，是数据结构设计的问题。

修复方案 #

1. 调整Firebase数据结构 #

不要把卖家名称作为顶级key存储，每个商品的字段结构调整为如下格式：

{
  "sku": "1111111111111",
  "count": 1,
  "sellerName": "PriceSmart",
  "price": 540.0
}

每个购物车商品文档单独存储自己的卖家名称、价格、sku、数量等信息，不要把不同商品的字段合并到同一个Map/文档里。

2. 调整数据拉取逻辑 #

你现在的代码是拉取单个cartItems下的单个文档的快照，要获取整个购物车的所有商品，需要查询cartItems集合的全部文档而不是单个文档：

// 调整Stream为集合快照而不是单个文档快照
Stream<QuerySnapshot> priceCollectionStream = FirebaseFirestore.instance
    .collection('shoppers')
    .doc(widget.loginService.loggedInUserModel!.uid)
    .collection("cartItems")
    .snapshots();

3. 适配渲染逻辑 #

集合快照返回后遍历所有文档，每个文档对应一件商品，单独取每个商品的卖家名称、价格等字段渲染即可，不会再出现同卖家key被覆盖的问题。

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