Flutter中如何不设置初始值使用DropdownButton且不触发异常？

你遇到的There should be exactly one item with [DropdownButton]'s value: .异常，是因为DropdownButton要求设置value时，必须在选项列表中找到完全匹配的项。如果不想设置初始值，可通过以下方式处理：

解决步骤 #

1. 修改自定义组件的value类型为可空
   将MyDropdownButton中的value字段改为可空类型，同时添加hint属性的显示逻辑，确保无初始值时展示提示文本：

class MyDropdownButton extends StatelessWidget {
  final String?                value; // 改为可空字符串类型
  final void Function(String?) onChanged;
  final List<String>           options;
  final String?                hintText;

  const MyDropdownButton({
    this.value, // 允许传入null
    required this.onChanged,
    required this.options,
    this.hintText,
    super.key,
  });

  List<DropdownMenuItem<String>> createOptions() {
    return options.toSet().map<DropdownMenuItem<String>>(
      (option) => DropdownMenuItem(value: option, child: Text(option))
    ).toList();
  }

  @override
  Widget build(BuildContext context) {
    return DropdownButtonHideUnderline(
      child: DropdownButton(
        elevation: 3,
        items: createOptions(),
        onChanged: onChanged,
        style: const TextStyle(
          color: Colors.black,
          fontSize: 15
        ),
        value: value,
        // 无初始值时显示提示文本
        hint: Text(hintText ?? '请选择'),
        isExpanded: true, // 可选：让按钮占满父容器宽度
      ),
    );
  }
}

2. 正常传入null作为初始值
   调用组件时直接传入null初始值即可，无需额外处理：

MyDropdownButton(
  value: widget.prefectureValue, // 初始为null也不会触发异常
  onChanged: widget.onChangedPrefecture,
  options: prefectures,
  hintText: '选择都道府县' // 可选自定义提示语
)

核心原理 #

当DropdownButton的value为null且设置了hint时，组件会优先展示提示文本，不会去校验value是否存在于选项列表中，自然避免了异常触发。用户选择选项后，onChanged回调会更新选中值，组件状态将正常切换。

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