Flutter中Firestore StreamSnapshot条件判断异常问题咨询

你的代码存在逻辑错误，并非Firestore的Bug。问题核心出在ListView.builder的itemBuilder回调逻辑里：

• 当第一个文档的0_competition_Whether字段为0时，itemBuilder在index=0的位置没有返回任何Widget，这违反了ListView.builder的强制要求——每个index必须返回一个合法的Widget。这种情况会触发渲染异常，导致整个列表无法正常渲染，所以所有卡片都消失了。
• 修改后续文档时，虽然单个index未返回Widget，但ListView的渲染机制暂时未触发全局异常，看起来只有对应卡片消失，但这同样是不规范写法，存在潜在崩溃风险。

两种修复方案 #

方案1：提前过滤数据（推荐） #

在构建ListView之前，先过滤掉不需要显示的文档，让itemCount和itemBuilder只处理符合条件的数据，逻辑更清晰，性能也更优：

Expanded(
  child: StreamBuilder(
    stream: FirebaseFirestore.instance.collection('championship').snapshots(),
    builder: (context, AsyncSnapshot<QuerySnapshot> streamSnapshot) {
      if(streamSnapshot.hasData){
        // 过滤出需要显示的文档
        final filteredDocs = streamSnapshot.data!.docs.where((doc) {
          final whetherOrNot = doc['0_competition_Whether'];
          return whetherOrNot != 0;
        }).toList();
        
        return ListView.builder(
          itemCount: filteredDocs.length,
          itemBuilder: (context, index){
            final DocumentSnapshot documentSnapshot = filteredDocs[index];
            
            void sendCompetition_main_page(){
              Navigator.push(context, MaterialPageRoute(
                builder: (context) => competition_main_page(documentSnapshot:documentSnapshot),
              ));
            }

            // 直接返回卡片，无需再判断条件
            return GestureDetector(
              onTap: sendCompetition_main_page,
              child: Card(
                elevation: 0,
                color: Colors.transparent,
                child: Container(
                  padding: const EdgeInsets.all(3),
                  margin: const EdgeInsets.fromLTRB(20, 0, 20, 3),
                  decoration: BoxDecoration(
                    border: Border.all(
                      color: Colors.grey,
                      width: 1,
                    ),
                    borderRadius: BorderRadius.circular(10),
                  ),
                  child: Row(
                    children: [
                      SizedBox(
                        width: 100,
                        height: 100,
                        child: Column(
                          mainAxisAlignment: MainAxisAlignment.center,
                          children: [
                            const Text('competition', style: TextStyle(fontSize: 19),),
                            Text(documentSnapshot['0_competition_Whether'].toString(), style: const TextStyle(fontSize: 20),),
                          ],
                        ),
                      ),
                      Container(
                        width: 1.4,
                        height: 100,
                        decoration: BoxDecoration(
                          border: Border.all(
                            color: Colors.grey,
                            width: 1,
                          ),
                          borderRadius: BorderRadius.circular(1),
                        ),
                      ),
                      const SizedBox(width: 15),
                      Padding(
                        padding: const EdgeInsets.all(10),
                        child: Column(
                          children: [
                            Text(documentSnapshot['1_main_competition'],
                              style: const TextStyle(
                                fontSize: 17,
                                fontWeight: FontWeight.bold,
                                color: Colors.black87,
                              ),
                            ),
                            const SizedBox(height: 10),
                            Text(documentSnapshot['2_place'],
                              style: const TextStyle(
                                fontSize: 16,
                                color: Colors.black,
                              ),
                            ),
                          ],
                        ),
                      )
                    ],
                  ),
                ),
              ),
            );
          },
        );
      } else {
        return const CircularProgressIndicator();
      }
    },
  ),
)

方案2：确保itemBuilder始终返回Widget #

如果不想提前过滤数据，在条件不满足时返回一个空容器，保证每个index都有合法的返回值：

Expanded(
  child: StreamBuilder(
    stream: FirebaseFirestore.instance.collection('championship').snapshots(),
    builder: (context, AsyncSnapshot<QuerySnapshot> streamSnapshot) {
      if(streamSnapshot.hasData){
        return ListView.builder(
          itemCount: streamSnapshot.data!.docs.length,
          itemBuilder: (context, index){
            final DocumentSnapshot documentSnapshot = streamSnapshot.data!.docs[index];
            
            void sendCompetition_main_page(){
              Navigator.push(context, MaterialPageRoute(
                builder: (context) => competition_main_page(documentSnapshot:documentSnapshot),
              ));
            }

            final whetherOrNot = documentSnapshot['0_competition_Whether'];
            
            if(whetherOrNot != 0){
              return GestureDetector(
                onTap: sendCompetition_main_page,
                child: Card(
                  elevation: 0,
                  color: Colors.transparent,
                  child: Container(
                    padding: const EdgeInsets.all(3),
                    margin: const EdgeInsets.fromLTRB(20, 0, 20, 3),
                    decoration: BoxDecoration(
                      border: Border.all(
                        color: Colors.grey,
                        width: 1,
                      ),
                      borderRadius: BorderRadius.circular(10),
                    ),
                    child: Row(
                      children: [
                        SizedBox(
                          width: 100,
                          height: 100,
                          child: Column(
                            mainAxisAlignment: MainAxisAlignment.center,
                            children: [
                              const Text('competition', style: TextStyle(fontSize: 19),),
                              Text(whetherOrNot.toString(), style: const TextStyle(fontSize: 20),),
                            ],
                          ),
                        ),
                        Container(
                          width: 1.4,
                          height: 100,
                          decoration: BoxDecoration(
                            border: Border.all(
                              color: Colors.grey,
                              width: 1,
                            ),
                            borderRadius: BorderRadius.circular(1),
                          ),
                        ),
                        const SizedBox(width: 15),
                        Padding(
                          padding: const EdgeInsets.all(10),
                          child: Column(
                            children: [
                              Text(documentSnapshot['1_main_competition'],
                                style: const TextStyle(
                                  fontSize: 17,
                                  fontWeight: FontWeight.bold,
                                  color: Colors.black87,
                                ),
                              ),
                              const SizedBox(height: 10),
                              Text(documentSnapshot['2_place'],
                                style: const TextStyle(
                                  fontSize: 16,
                                  color: Colors.black,
                                ),
                              ),
                            ],
                          ),
                        )
                      ],
                    ),
                  ),
                ),
              );
            } else {
              // 条件不满足时返回空容器，避免渲染异常
              return const SizedBox.shrink();
            }
          },
        );
      } else {
        return const CircularProgressIndicator();
      }
    },
  ),
)

注：原代码中whetherornotValue变量未定义，修改后的代码替换为documentSnapshot['0_competition_Whether'].toString()，你可根据实际需求调整。

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