Flutter中Dialog内DropdownMenu的TextEditingController释放后复用报错

报错的核心是你复用了一个已经被 dispose 的TextEditingController实例。

当Dialog关闭时，Flutter会自动销毁Dialog对应的Widget树，包括树中所有State对象。如果你的categoryIdController是在Dialog内部的State（或StatefulBuilder关联的上下文）中创建，并且在State的dispose方法中调用了categoryIdController.dispose()，那么这个Controller会被标记为已释放。再次打开Dialog时，若仍使用这个已失效的Controller实例，就会触发该断言错误。

根据代码结构，有两种常见修复方式：

1. 每次打开Dialog时新建Controller实例 #

在showDialog的builder函数内部创建Controller，确保每次打开Dialog都用全新实例，避免复用已释放对象：

showDialog(
  context: context,
  builder: (context) {
    // 每次打开Dialog时新建Controller
    final categoryIdController = TextEditingController();
    return StatefulBuilder(
      builder: (context, setState) {
        return AlertDialog(
          content: DropdownMenu(
            controller: categoryIdController,
            hintText: 'Select a Category',
            onSelected: (value) => setState(() {
              pageCategoryId = value ?? '';
            }),
            dropdownMenuEntries: List.generate(
              categoryList.length,
              (index) => DropdownMenuEntry<String>(
                value: categoryList[index].id,
                label: categoryList[index].name,
              ),
            ),
          ),
        );
      },
    );
  },
);

2. 将Controller提升到父Widget中管理 #

如果需要保留Dialog关闭前的选中状态，把categoryIdController移到Dialog所在的父Widget的State中创建，仅在父Widget销毁时释放Controller：

class ParentWidget extends StatefulWidget {
  const ParentWidget({super.key});

  @override
  State<ParentWidget> createState() => _ParentWidgetState();
}

class _ParentWidgetState extends State<ParentWidget> {
  late final TextEditingController categoryIdController;
  String pageCategoryId = '';
  List<Category> categoryList = []; // 假设你的分类列表

  @override
  void initState() {
    super.initState();
    categoryIdController = TextEditingController();
  }

  @override
  void dispose() {
    // 仅在父Widget销毁时释放Controller
    categoryIdController.dispose();
    super.dispose();
  }

  void _openCategoryDialog() {
    showDialog(
      context: context,
      builder: (context) {
        return StatefulBuilder(
          builder: (context, setState) {
            return AlertDialog(
              content: DropdownMenu(
                controller: categoryIdController,
                hintText: 'Select a Category',
                onSelected: (value) => setState(() {
                  pageCategoryId = value ?? '';
                }),
                dropdownMenuEntries: List.generate(
                  categoryList.length,
                  (index) => DropdownMenuEntry<String>(
                    value: categoryList[index].id,
                    label: categoryList[index].name,
                  ),
                ),
              ),
            );
          },
        );
      },
    );
  }

  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: _openCategoryDialog,
      child: const Text('Open Dialog'),
    );
  }
}

• 永远不要复用已调用过dispose()的Controller实例，Flutter会严格检查这一点。
• 若Controller需要跨Dialog生命周期保留状态，必须将其生命周期与父Widget绑定，而非Dialog内部。

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