Flutter DropdownButton报错：指定value无匹配或存在重复项

报错核心原因 #

这个断言错误的本质是：DropdownButton的value必须和且仅和一个DropdownMenuItem的value完全匹配。你遇到的情况要么是：

• 下拉列表里没有value为Seleccionar的选项，但你把DropdownButton的value设成了它；
• 下拉列表里存在≥2个value为Seleccionar的选项，导致匹配到多个结果。

针对setDefaultSelection控制无效的解决方案 #

1. 确保默认选项唯一
   先定义明确的默认值常量，构建下拉选项列表时，只添加一次默认项，同时保证业务选项里不包含和默认值重复的内容：

   const String defaultSelect = 'Seleccionar';
   
   List<DropdownMenuItem<String>> buildMenuItems(List<String> businessOptions) {
     final List<DropdownMenuItem<String>> items = [];
     // 只添加一次默认项
     items.add(DropdownMenuItem(
       value: defaultSelect,
       child: Text(defaultSelect),
     ));
     // 遍历业务选项，避免重复
     for (var option in businessOptions) {
       if (option != defaultSelect) {
         items.add(DropdownMenuItem(
           value: option,
           child: Text(option),
         ));
       }
     }
     return items;
   }
   

2. 同步默认值与选中状态
   用setDefaultSelection控制选中值时，要确保选中值始终存在于下拉选项的value集合中：

   String? selectedValue;
   bool setDefaultSelection = true; // 你的控制变量
   
   @override
   void initState() {
     super.initState();
     // 初始化选中值
     selectedValue = setDefaultSelection ? defaultSelect : null;
   }
   
   // 更新选中状态的方法
   void onSelectChanged(String? newValue) {
     setState(() {
       selectedValue = newValue;
     });
   }
   

移除value后下拉异常的修复 #

移除value后异常，通常是因为没有处理无选中状态的情况。可以通过以下两种方式解决：

• 添加hint属性：当没有选中值时显示提示文本，替代默认选中第一个选项的行为：

  DropdownButton<String>(
    hint: const Text('Seleccionar'),
    items: buildMenuItems(yourBusinessOptions),
    onChanged: onSelectChanged,
  )
  

• 确保下拉列表非空再渲染：如果列表是动态加载的，在数据未加载完成时显示加载提示，避免渲染空列表的DropdownButton：

  if (yourBusinessOptions.isEmpty) {
    return const CircularProgressIndicator();
  }
  return DropdownButton<String>(
    value: selectedValue,
    items: buildMenuItems(yourBusinessOptions),
    onChanged: onSelectChanged,
  );
  

隐藏的重复值排查 #

如果代码里没明显重复添加默认项，但还是报错，可能是字符串存在隐藏的空格或编码差异（比如'Seleccionar '和'Seleccionar'）。可以打印hashCode验证：

// 打印所有选项的value和hashCode
for (var item in buildMenuItems(yourBusinessOptions)) {
  print('Value: ${item.value}, Hash: ${item.value.hashCode}');
}
// 打印当前选中值的hashCode
print('Selected Value: $selectedValue, Hash: ${selectedValue?.hashCode}');

如果hashCode不一致，说明字符串实际不相等，需要统一处理字符串格式（比如用trim()去掉空格）。

内容的提问来源于stack exchange，提问作者Juan Peralta Torres