Flutter中从上一页面传入的Dropdown selectedValue无法更新

高频触发原因 #

• 最容易忽略的硬规则：DropdownButton要求传入的selectedValue必须严格存在于所有items的value集合中，且值、类型完全匹配。如果传入值不在选项列表内（比如上一页传的是String类型的"1"，选项value是int类型的1，或者自定义对象未重写相等判断），组件会直接忽略传入的选中值，不会同步状态。
• 变量作用域遮蔽：在build方法、事件回调内声明了和全局成员变量同名的局部selectedValue，setState修改的是局部变量，State持有的全局状态根本没变化。
• 初始值赋值时机错误：把上一页传入参数赋值给selectedValue的逻辑写在了build方法里，每次组件重建都会把选中值重置为初始入参，看起来就像setState完全没生效。
• 组件被const修饰：DropdownButton或者它的父级组件被加了const关键字，状态变化时组件不会触发重建。

对应修复步骤 #

1. 把初始值赋值逻辑移到initState生命周期，绝对不要在build方法内给selectedValue赋初始值：

late String selectedValue;

@override
void initState() {
  super.initState();
  // 仅在组件初始化时读取一次路由传参作为默认选中值
  selectedValue = ModalRoute.of(context)!.settings.arguments as String;
}

2. 做值匹配校验：把当前selectedValue和所有item的value做对比，确认类型、值完全一致。如果用自定义类作为选项value，必须重写类的==运算符和hashCode，确保同属性不同实例能被判定为相等。
3. 检查setState逻辑：选中值的赋值操作必须写在setState的回调内，且修改的是State类持有的成员变量，不要在setState外部提前修改变量：

onChanged: (newVal) {
  setState(() {
    selectedValue = newVal as String;
  });
}

4. 移除DropdownButton及父组件上不必要的const修饰符，保证状态变化时组件能正常重建刷新。

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