构建FutureBuilder<DocumentSnapshot<Object?>>时抛出NoSuchMethodError异常

异常原因分析 #

抛出NoSuchMethodError的核心原因是调用了null对象或非预期类型对象的方法，结合你的代码，具体可能是以下情况：

• Firestore目标文档中不存在subCat字段，或字段名拼写错误（Firestore字段名大小写敏感），导致snapshot.data!['subCat']返回null，后续调用data.length时触发异常（null没有length方法）。
• subCat字段的类型不是List（比如是Map、字符串或其他类型），调用data.length或data[index]时，非List类型没有这些方法，从而抛出异常。
• 代码仅判断了连接状态和文档存在性，但未对subCat的存在性和类型做校验，直接强取并调用方法，容错性不足。

解决方法 #

1. 检查Firestore文档结构 #

登录Firebase控制台，找到对应的categories集合，打开目标文档，确认：

• 存在名为subCat的字段，拼写完全一致（包括大小写）。
• subCat的字段类型为数组（Array），而非其他类型。

2. 增强代码容错性 #

修改FutureBuilder内的逻辑，增加空值和类型校验：

if (snapshot.connectionState == ConnectionState.waiting) {
  return Center(child: CircularProgressIndicator());
}

// 先判空，不存在则返回空List避免报错
var data = snapshot.data!['subCat'] ?? [];
// 校验类型是否为List
if (data is! List) {
  return Text("数据格式错误：subCat应为数组类型");
}

return ListView.builder(
  itemCount: data.length,
  itemBuilder: (BuildContext context, int index) {
    return Padding(
      padding: const EdgeInsets.only(left: 8, right: 8),
      child: ListTile(
        onTap: () {},
        title: Text(
          data[index].toString(), // 增加toString避免非字符串类型报错
          style: TextStyle(fontSize: 15),
        ),
      ),
    );
  },
);

3. 优化请求逻辑（可选） #

既然已经通过路由参数传递了DocumentSnapshot，可以直接使用该快照中的数据，无需再次请求Firestore，减少网络开销和潜在的不一致问题：

// 替换原来的FutureBuilder部分
var data = args['subCat'] ?? [];
if (data is! List) {
  return Text("数据格式错误：subCat应为数组类型");
}

return ListView.builder(
  itemCount: data.length,
  itemBuilder: (BuildContext context, int index) {
    return Padding(
      padding: const EdgeInsets.only(left: 8, right: 8),
      child: ListTile(
        onTap: () {},
        title: Text(
          data[index].toString(),
          style: TextStyle(fontSize: 15),
        ),
      ),
    );
  },
);

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