Flutter中StreamBuilder报DocumentSnapshotPlatform字段不存在错误

问题描述 #

在Flutter项目的SoldItemScreen页面使用StreamBuilder监听Firestore的items集合数据时，出现红色错误界面，提示“Bad state: field does not exist within the DocumentSnapshotPlatform”。更新项目依赖包后，该错误依然存在。

错误信息 #

构建StreamBuilder<QuerySnapshot<Map<String,dynamic>>>时抛出StateError：

Bad state: field does not exist within the DocumentSnapshotPlatform

引发错误的组件为：

StreamBuilder<QuerySnapshot<Map<String, dynamic>>>
路径：file:///C:/Users/flutt/Desktop/New%20folder/MarcJr-main/Logisyntax-MarcJr-master/lib/pages/Ecommerce/SellerDashboard/SoldItemScreen.dart:34:20

错误堆栈 #

异常抛出时的堆栈信息：
#0      DocumentSnapshotPlatform.get._findKeyValueInMap (package:cloud_firestore_platform_interface/src/platform_interface/platform_interface_document_snapshot.dart:87:7)
#1      DocumentSnapshotPlatform.get._findComponent (package:cloud_firestore_platform_interface/src/platform_interface/platform_interface_document_snapshot.dart:105:23)
#2      DocumentSnapshotPlatform.get (package:cloud_firestore_platform_interface/src/platform_interface/platform_interface_document_snapshot.dart:121:12)
#3      _JsonDocumentSnapshot.get (package:cloud_firestore/src/document_snapshot.dart:92:48)
#4      _JsonDocumentSnapshot.[] (package:cloud_firestore/src/document_snapshot.dart:96:40)
#5      _SoldItemScreensState.build..
(package:marcjrfoundation/pages/Ecommerce/SellerDashboard/SoldItemScreen.dart:63:39)
#6      MappedListIterable.elementAt (dart:_internal/iterable.dart:413:31)
#7      ListIterator.moveNext (dart:_internal/iterable.dart:342:26)
#8      new _GrowableList._ofEfficientLengthIterable (dart:core-patch/growable_array.dart:189:27)
#9      new _GrowableList.of (dart:core-patch/growable_array.dart:150:28)
#10     new List.of (dart:core-patch/array_patch.dart:51:28)
#11     ListIterable.toList (dart:_internal/iterable.dart:213:44)
#12     _SoldItemScreensState.build. (package:marcjrfoundation/pages/Ecommerce/SellerDashboard/SoldItemScreen.dart:89:22)
#13     StreamBuilder.build (package:flutter/src/widgets/async.dart:444:81)
#14     _StreamBuilderBaseState.build (package:flutter/src/widgets/async.dart:124:48)
#15     StatefulElement.build (package:flutter/src/widgets/framework.dart:4992:27)
#16     ComponentElement.performRebuild (package:flutter/src/widgets/framework.dart:4878:15)
#17     StatefulElement.performRebuild (package:flutter/src/widgets/framework.dart:5050:11)
#18     Element.rebuild (package:flutter/src/widgets/framework.dart:4604:5)
#19     BuildOwner.buildScope (package:flutter/src/widgets/framework.dart:2667:19)

相关代码 #

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter/material.dart';
import 'package:marcjrfoundation/services/SharedPreferences/sharedprefs_helper.dart';
import 'package:marcjrfoundation/services/device_size.dart';
import 'package:websafe_svg/websafe_svg.dart';

import '../ProductItem/sellerProductItem.dart';

class SoldItemScreens extends StatefulWidget {
  static final String tag = '/soldItemScreen';
  @override
  _SoldItemScreensState createState() => _SoldItemScreensState();
}

class _SoldItemScreensState extends State<SoldItemScreens> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      resizeToAvoidBottomInset: true,
      appBar: AppBar(
        title: Text(
          'Sold Products',
          style: TextStyle(
              fontSize: ResponsiveWidget.isSmallScreen(context) ? 17.0 : 25.0),
        ),
      ),
      body: Column(
        children: [
          SizedBox(
            height: 10.0,
          ),
          Container(
            color: Color(0xffF7F7F7),
            child: StreamBuilder(
              stream: FirebaseFirestore.instance
                  .collection("items")
                  .where('seller', isEqualTo: parentIdGlobal)
                  .where('isSold', isEqualTo: true)
                  .snapshots(),
              builder: (BuildContext context, AsyncSnapshot snapshot) {
                if (!snapshot.hasData)
                  return Center(
                    child: CircularProgressIndicator(),
                  );
                List<DocumentSnapshot<Object>> docs = snapshot.data!.docs;
                if (docs.length == 0) {
                  return Center(
                    child: Padding(
                      padding: const EdgeInsets.all(10.0),
                      child: WebsafeSvg.asset(
                        'assets/images/sold-out.svg',
                        fit: BoxFit.cover,
                        height: MediaQuery.of(context).size.height / 5,
                      ),
                    ),
                  );
                }
                return ListView(
                  scrollDirection: Axis.vertical,
                  shrinkWrap: true,
                  children: docs.map((DocumentSnapshot doc) {
                    bool isSold = doc['isSold'];
                    bool isLiked = doc['isLiked'];
                    String itemId = doc['itemId'];
                    String seller = doc['seller'];
                    String sellerName = doc['sellerName'];
                    String title = doc['title'];
                    String desc = doc['desc'];
                    String price = doc['price'];
                    String condition = doc['condition'];
                    String category = doc['category'];
                    String location = doc['location'];
                    String itemImage = doc['imageDownloadUrl'];

                    return SellerProductItem(
                      itemId: itemId,
                      seller: seller,
                      sellerName: sellerName,
                      title: title,
                      desc: desc,
                      price: price,
                      itemImage: itemImage,
                      isLiked: isLiked,
                      isSold: isSold,
                      category: category,
                      condition: condition,
                      location: location,
                    );
                  }).toList(),
                );
              },
            ),
          ),
        ],
      ),
    );
  }
}

问题原因 #

错误根源是尝试从Firestore的DocumentSnapshot中读取不存在的字段，或者items集合中部分已售出文档缺少代码中要读取的某个字段。从错误堆栈第5行可定位到问题出在SoldItemScreen.dart第63行的字段读取操作。

解决方案 #

1. 检查Firestore文档完整性 #

登录Firebase控制台，查看items集合中isSold=true的所有文档，确认每个文档都包含以下字段：isSold、isLiked、itemId、seller、sellerName、title、desc、price、condition、category、location、imageDownloadUrl。若有文档缺失字段，补充完整。

2. 安全读取字段避免崩溃 #

不要直接用doc['字段名']读取，改用带默认值的安全读取方式：

// 示例：给缺失字段设置默认值
bool isSold = doc.get('isSold', defaultValue: false);
bool isLiked = doc.get('isLiked', defaultValue: false);
String itemId = doc.get('itemId', defaultValue: '');
String sellerName = doc.get('sellerName', defaultValue: '未知卖家');
// 其他字段同理替换

3. 明确泛型类型提升类型安全 #

给StreamBuilder和文档列表指定明确的泛型类型，避免类型转换问题：

StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
  stream: FirebaseFirestore.instance
      .collection("items")
      .where('seller', isEqualTo: parentIdGlobal)
      .where('isSold', isEqualTo: true)
      .snapshots(),
  builder: (BuildContext context, AsyncSnapshot<QuerySnapshot<Map<String, dynamic>>> snapshot) {
    if (snapshot.hasError) {
      return Center(child: Text('加载出错: ${snapshot.error}'));
    }
    if (!snapshot.hasData) {
      return Center(child: CircularProgressIndicator());
    }
    List<QueryDocumentSnapshot<Map<String, dynamic>>> docs = snapshot.data!.docs;
    // 后续代码逻辑保持不变
  },
)

4. 添加错误处理逻辑 #

在StreamBuilder中处理snapshot.hasError的情况，避免直接显示红色错误界面：

if (snapshot.hasError) {
  return Center(child: Text('加载出错: ${snapshot.error}'));
}

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