Flutter从Firestore填充DropdownButton时出现重复值断言错误

错误核心原因 #

这个断言错误的本质是：DropdownButton的value属性值，在所有DropdownMenuItem的value中不存在，或者存在多个重复匹配项，对应到你的代码，问题可能出在这几点：

1. 初始_value未设为null，且没有匹配的选项；
2. 未处理StreamBuilder的加载、无数据状态，直接访问snapshot.data!会导致空列表但_value有值的矛盾；
3. Firestore集合中存在多个文档的data["id"]值重复，导致多个DropdownMenuItem的value相同；
4. 手动设置的data["id"]不如Firestore自带的文档ID可靠，容易出现重复。

修复方案及代码修改 #

1. 正确初始化_value #

确保_value初始值为null，未选择时不会和任何选项冲突：

String? _value = null;

2. 处理StreamBuilder的全状态 #

在builder中先判断snapshot状态，避免加载/错误时直接渲染DropdownButton：

StreamBuilder<QuerySnapshot>(
  stream: FirebaseFirestore.instance.collection('guests').snapshots(),
  builder: (BuildContext context, AsyncSnapshot<QuerySnapshot> snapshot) {
    // 加载中状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator(color: Color(0xff11b719));
    }
    // 加载错误状态
    if (snapshot.hasError) {
      return Text('加载失败: ${snapshot.error}');
    }
    // 无数据状态
    if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
      return const Text('暂无可选项');
    }

    // 生成下拉选项，改用Firestore文档ID作为value（确保唯一）
    final currencyItems = snapshot.data!.docs.map((doc) {
      final data = doc.data()! as Map<String, dynamic>;
      return DropdownMenuItem(
        value: doc.id, // 用系统生成的文档ID替代自定义id，避免重复
        child: Text(data["name"] ?? '未知名称'), // 空值保护
      );
    }).toList();

    return DropdownButton(
      items: currencyItems,
      onTap: () => print(currencyItems),
      onChanged: (currencyValue) {
        setState(() => _value = currencyValue);
        // 用新版ScaffoldMessenger显示SnackBar
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(
            content: Text(
              '选中值: $currencyValue',
              style: const TextStyle(color: Color(0xff11b719)),
            ),
          ),
        );
      },
      value: _value,
      isExpanded: false,
      hint: const Text(
        "选择类型",
        style: TextStyle(color: Color(0xff11b719)),
      ),
    );
  },
),

3. 确保选项value唯一 #

如果坚持使用自定义的data["id"]，必须检查Firestore集合中所有文档的id字段是否唯一，避免重复值触发断言错误。优先推荐使用Firestore自带的doc.id，它是系统自动生成的唯一标识，无需手动维护。

额外优化点 #

• 给data["name"]加空值保护，避免某个文档缺少该字段导致崩溃；
• 使用ScaffoldMessenger替代旧版Scaffold.of(context)，适配Flutter新版本；
• 将currencyItems声明为局部变量，避免全局变量带来的状态混乱。

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