Flutter中Firestore集合读取遇RangeError索引越界问题求助

错误信息 #

E/flutter (  640): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: RangeError (index): Invalid value: Valid value range is empty: 0

问题描述 #

代码能正常监听Firestore快照，但点击按钮时抛出上述索引越界错误。尝试用data.docs[0]['text']读取集合chats/MTIH4O2WFPWDvCso107p/messages中第一个文档的text字段，按官方文档理解这应该能获取对应值，但实际要么返回空值要么报错。

相关代码 #

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

class ChatScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: ListView.builder(
        itemCount: 10,
        itemBuilder: (ctx, index) => Container(
          padding: EdgeInsets.all(8),
          child: Text('This Works!'),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        child: Icon(Icons.add),
        onPressed: () {
          FirebaseFirestore.instance
              .collection('chats/MTIH4O2WFPWDvCso107p/messages')
              .snapshots()
              .listen((data) {
            //print(data.toString());
            print(data.docs[0]['text']);
          });
        },
      ),
    );
  }
}

Firestore文档截图 #

问题原因及解决办法 #

• 核心问题：直接访问data.docs[0]未先判断文档列表是否为空，当集合无文档、快照未同步到最新数据时，就会触发索引越界错误。同时需确认子集合路径、文档存在性及访问权限。
• 修复方案：
  1. 增加空列表判断：在访问索引前先检查文档列表是否非空，避免报错：

     onPressed: () {
       FirebaseFirestore.instance
           .collection('chats/MTIH4O2WFPWDvCso107p/messages')
           .snapshots()
           .listen((data) {
         if (data.docs.isNotEmpty) {
           print(data.docs[0]['text']);
         } else {
           print("集合中无文档");
         }
       });
     },
     

  2. 校验路径与权限：确认Firestore安全规则允许当前用户读取该集合，同时检查集合路径（文档ID、子集合名称）拼写完全正确。
  3. 单次读取改用get()：如果不需要实时监听数据，用get()替代snapshots()更合适，避免重复创建监听：

     onPressed: () async {
       var data = await FirebaseFirestore.instance
           .collection('chats/MTIH4O2WFPWDvCso107p/messages')
           .get();
       if (data.docs.isNotEmpty) {
         print(data.docs[0]['text']);
       }
     },
     

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