Flutter DropdownButton断言错误求助：值匹配项数量异常

错误核心原因 #

这个断言失败的本质是DropdownButton的value属性必须满足以下任一规则：

• value为null
• 选项列表items为空
• 恰好有一个DropdownMenuItem的value与当前value完全匹配

你将value初始化为空字符串""，但选项列表里没有值为空字符串的选项，导致匹配数量为0，触发了断言校验失败。

具体解决方法 #

方法1：将初始value设为null #

直接把DropdownButton的初始value改为null，符合断言允许的条件：

DropdownButton(
  value: null, // 替换原有的空字符串
  items: [
    DropdownMenuItem(value: "m", child: Text("米")),
    DropdownMenuItem(value: "km", child: Text("千米")),
    // 其他单位选项
  ],
  onChanged: (newValue) {
    // 处理选中值变更的逻辑
  },
)

方法2：添加空字符串对应的选项（按需使用） #

如果业务场景需要保留初始空字符串作为可选状态，可以在选项列表中添加对应的项：

DropdownButton(
  value: "", // 保留初始空字符串
  items: [
    DropdownMenuItem(value: "", child: Text("请选择单位")), // 新增对应选项
    DropdownMenuItem(value: "m", child: Text("米")),
    DropdownMenuItem(value: "km", child: Text("千米")),
  ],
  onChanged: (newValue) {
    // 处理选中值变更的逻辑
  },
)

方法3：初始value设为列表第一个选项值 #

如果页面加载时需要默认选中一个有效单位，直接将初始value设为选项列表里第一个项的value：

final List<DropdownMenuItem<String>> unitItems = [
  DropdownMenuItem(value: "m", child: Text("米")),
  DropdownMenuItem(value: "km", child: Text("千米")),
];

// 在DropdownButton中使用
DropdownButton(
  value: unitItems[0].value, // 默认选中第一个选项
  items: unitItems,
  onChanged: (newValue) {
    // 处理选中值变更的逻辑
  },
)

额外注意事项 #

• 确保所有DropdownMenuItem的value没有重复，否则会触发“匹配数量≥2”的断言错误
• 更新value时，要保证新值一定存在于items的value列表中

内容的提问来源于stack exchange，提问作者Ngọc Trần