Flutter 基于Firestore生成唯一值实现无重复下拉菜单

我有一个下拉菜单，当前通过如下代码从Firestore拉取数据完成填充：

FutureBuilder<QuerySnapshot>(
    future: FirebaseFirestore.instance
        .collection('field_management')
        .orderBy('cultivar_name')
        .get(),
    builder: (context, snapshot) {
      if (!snapshot.hasData) {
        return const SizedBox(
          height: 15.0,
          width: 15.0,
          child: Center(
            child: CircularProgressIndicator(),
          ),
        );
      }
      return DropdownButton(
        onChanged: (newValue) {
          setState(() {
            cultivarDropdownValue =
                newValue.toString();
          });
        },
        hint: Text(cultivarDropdownValue),
        items: snapshot.data!.docs
            .map((DocumentSnapshot document) {
          return DropdownMenuItem<String>(
            value: document['cultivar_name'],
            child:
            Text(document['cultivar_name']),
          );
        }).toList(),
      );
    },
  ),

需要实现的需求：基于Firestore返回的数据生成去重的唯一值列表，避免下拉菜单中出现重复选项。

此前我曾尝试在initState()方法中编写逻辑向列表添加项（实现代码如下），但仍然会获取到集合中的全部值（包含重复项），不清楚可行的实现方案。

addDropDownItems() async {
    return await FirebaseFirestore.instance
        .collection('field_management')
        .get()
        .then((snapshot) {
      for (dynamic document in snapshot.docs) {
        if (!blockList.contains(document.data())) {
          blockList.add(document.data());
        }
      }
      print('block list: ${blockList}');
    });
  }

你之前的去重逻辑失效有两个核心问题：

• 去重判断维度错误：用整个文档对象document.data()作为重复判断依据，但下拉选项实际唯一标识是cultivar_name字段。不同文档即使cultivar_name值一致，其余字段、对象内存地址都可能不同，contains方法无法识别这类重复。
• 代码书写错误：blockList.add(document.data())漏了方法调用括号，实际加入列表的是函数引用而非文档数据，逻辑完全不生效。

根据你的数据量规模，可以选择以下两种方案实现：

方案1：客户端本地去重（改造成本最低） #

适合集合文档量在1000条以内的场景，不需要调整Firestore侧配置，直接利用Dart的Set天然去重特性处理返回数据即可，修改后的完整代码如下：

FutureBuilder<QuerySnapshot>(
    future: FirebaseFirestore.instance
        .collection('field_management')
        .orderBy('cultivar_name')
        .get(),
    builder: (context, snapshot) {
      if (!snapshot.hasData) {
        return const SizedBox(
          height: 15.0,
          width: 15.0,
          child: Center(
            child: CircularProgressIndicator(),
          ),
        );
      }
      // *核心去重逻辑*：提取所有cultivar_name字段，转Set自动去重后转回列表
      final uniqueCultivars = snapshot.data!.docs
          .map((doc) => doc['cultivar_name'] as String)
          .toSet()
          .toList();

      return DropdownButton<String>(
        onChanged: (newValue) {
          setState(() {
            cultivarDropdownValue = newValue ?? '';
          });
        },
        value: cultivarDropdownValue.isEmpty ? null : cultivarDropdownValue,
        hint: Text(cultivarDropdownValue.isEmpty ? '请选择品种' : cultivarDropdownValue),
        items: uniqueCultivars.map((cultivarName) {
          return DropdownMenuItem<String>(
            value: cultivarName,
            child: Text(cultivarName),
          );
        }).toList(),
      );
    },
  ),

上述代码顺便修复了原DropdownButton组件value与hint逻辑冲突可能触发的运行时报错。

如果你需要在initState阶段提前拉取去重后的数据，正确的实现写法如下：

List<String> blockList = [];

Future<void> addDropDownItems() async {
  final snapshot = await FirebaseFirestore.instance
      .collection('field_management')
      .get();
  final nameSet = <String>{};
  for (final doc in snapshot.docs) {
    final cultivarName = doc['cultivar_name'] as String;
    // Set.add返回true代表值不存在，为新的唯一值
    if (nameSet.add(cultivarName)) {
      blockList.add(cultivarName);
    }
  }
  // 数据拉取处理完成后刷新UI
  setState(() {});
  print('去重后的品种列表: $blockList');
}

方案2：数据结构优化（适合大数据量场景） #

Firestore原生不支持类SQL的distinct去重查询，如果你的集合文档量很大，每次拉取全量数据再在客户端去重会浪费读取配额和流量。建议单独维护一个cultivars集合，每个文档对应一个唯一的品种名称，写入field_management数据时同步校验维护这个集合，保证集合内无重复值。下拉菜单直接读取cultivars集合即可，不需要额外做去重处理，查询性能最优。

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