Flutter DropDownMultiSelect报DropdownButton值错误如何修复

安全阿岳

2026-8-27

报错翻译

控制台抛出的错误原文翻译：

[DropdownButton]值匹配异常：要求传入的选中值必须恰好对应唯一的[DropdownMenuItem]，当前检测到值为c的项要么不存在匹配项，要么存在2个及以上value重复的同名选项。

排查思路

按优先级从高到低排查：

检查所有DropDownMultiSelect的options列表是否存在重复值：多选下拉底层基于Flutter原生DropdownButton实现，要求所有选项值唯一，哪怕是带前后空格的视觉重复值（比如'Politics'和' Politics'）也会触发报错。
检查selectedValues传入的选中列表是否包含不在对应options范围内的值：只要选中值不在选项列表里，底层找不到对应匹配项就会抛错，重点检查是否有initState、接口赋值逻辑提前给选中列表塞了非法值。
检查Widget布局结构合法性：你贴的代码里body部分的Container嵌套存在语法问题，Container仅支持单个child，你直接在Container下并列放置了多个组件，没有用Column/ListView这类多子布局包裹，会导致组件上下文错乱，配置参数传递异常。
避开低版本组件的变量名冲突bug：你在第四个（Children模块）下拉的onChanged回调里把参数命名为单字符c，和0.0.x低版本dropdown_multi_select组件内部的局部变量重名，会导致内部解析时把参数名c当成选中值传入，这也是本次报错直接提到值为c的核心原因。

修复方案

先修正body布局结构，所有表单项统一放到支持滚动的多子布局中，避免溢出和层级错乱，示例结构如下：

body: SingleChildScrollView(
  padding: EdgeInsets.all(16),
  child: Column(
    crossAxisAlignment: CrossAxisAlignment.start,
    children: [
      // 原Looking for模块、间距、Politics模块等所有表单项按顺序放在这里，去掉多余的无效Container嵌套
    ],
  ),
)

把所有onChanged回调的单字符参数名改成有语义的名称，避免和组件内部变量冲突，同时赋值时做一次列表拷贝，不要直接引用组件内部返回的列表对象：

// 以Children模块的下拉为例，其余四个下拉按同样方式修改
DropDownMultiSelect(
  onChanged: (List<String> selectedChildrenVal) {
    setState(() {
      // 用List.from生成新列表对象，避免和组件内部列表产生联动引用
      selected3 = List.from(selectedChildrenVal);
    });
  },
  options: ['One day' , "Have + don't want more" , 'Have and want more' , 'Do not want', 'Undecided'],
  selectedValues: selected3,
  whenEmpty: 'Please select',
  // 补充装饰和密度参数，避免空状态下内部布局计算异常
  isDense: true,
  decoration: InputDecoration(
    border: OutlineInputBorder(),
    contentPadding: EdgeInsets.symmetric(horizontal: 10, vertical: 8),
  ),
)

修正选项拼写问题：第一个Looking for模块的options里的Unsur是拼写错误，建议改成Unsure。
如果存在拉取用户已有资料回填表单的逻辑，赋值前先过滤选中值：只要值不在对应options列表里就直接丢弃，不要传入selectedValues。

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