Flutter中DropdownButton出现DropdownMenuItem断言异常如何解决

报错触发逻辑 #

这个断言是DropdownButton的内置校验规则：组件要求传入的value必须满足：

• 不能和列表里多个DropdownMenuItem的value重复
• 必须能在所有DropdownMenuItem的value集合里找到唯一匹配项
  只要不满足任意一条就会抛你遇到的_AssertionError，结合你贴的代码和报错提示（当前绑定值为2），问题来自两处代码错误：
• DropdownButton构造函数第一个位置多传了无效参数setter.map(function).toList()，打乱了属性绑定逻辑
• getPriorityAsString(note.priority)的返回值和菜单项不匹配：你生成的DropdownMenuItem value全是String类型，报错显示当前绑定值是数字2，要么是这个方法返回了int类型值导致类型不匹配，要么是返回的字符串不在_priorities列表范围内，找不到对应菜单项。

修复步骤 #

• 删除DropdownButton构造函数首行多余的setter.map(function).toList()无效传参
• 给DropdownButton显式声明泛型为String，避免类型隐式转换导致的匹配失败
• 校验getPriorityAsString方法的返回值：必须是_priorities列表中存在的字符串，不能返回列表外的值，也不能返回int等其他类型
• 检查_priorities列表本身，确保没有重复的字符串元素，避免同value多菜单项的问题
• 给onChanged回调加空值判断，兼容空安全语法

修正后可运行代码 #

ListTile(
  title: DropdownButton<String>(
    items: _priorities.map((String dropdownStringItem) {
      return DropdownMenuItem<String>(
        value: dropdownStringItem,
        child: Text(dropdownStringItem),
      );
    }).toList(),
    style: textStyle,
    // 示例逻辑：如果note.priority是int类型的2，这里要返回_priorities里对应位置的字符串，比如'高'
    value: getPriorityAsString(note.priority),
    onChanged: (String? valueSelectedByUser) {
      if (valueSelectedByUser == null) return;
      setState(() {
        updatePriorityAsInt(valueSelectedByUser);
        debugPrint('User selected $valueSelectedByUser');
      });
    },
  ),
),

快速排查技巧 #

如果改完还是报错，可以在构建DropdownButton前加两行打印日志，直接定位不匹配的点：

debugPrint('当前绑定值：${getPriorityAsString(note.priority)}，类型：${getPriorityAsString(note.priority).runtimeType}');
debugPrint('所有菜单项值：$_priorities');

对比打印结果，就能立刻看出是类型不对，还是绑定值不在菜单项列表里。

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