Flutter模拟器报错：failed assertion:line 5054 '_dependents.isEmpty' is not true

这个报错的核心原因是**DefaultTabController被放置在StatefulWidget的build方法内部**，每次组件重建时会创建新的控制器实例，而旧控制器仍被TabBar/TabBarView持有依赖，触发了框架的断言检查。

方案一：将DefaultTabController移到build方法外部 #

把控制器提升到父组件层级，确保它不会随StatefulWidget的重建而频繁创建销毁：

修改MyApp代码：

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(primarySwatch: Colors.teal),
      // 将DefaultTabController移到这里，作为MyHomePage的父组件
      home: DefaultTabController(
        initialIndex: 1,
        length: 3,
        child: const MyHomePage(title: 'Flutter Demo Home Page'),
      ),
    );
  }
}

然后简化MyHomePage的build方法：

@override
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: Text(widget.title),
      actions: [IconButton(icon: Icon(Icons.person), onPressed: (){})],
      bottom: TabBar(
        tabs: const <Widget>[
          Tab(icon: Icon(Icons.note_alt)),
          Tab(icon: Icon(Icons.list_alt)),
          Tab(icon: Icon(Icons.settings)),
        ],
      ),
    ),
    body: const TabBarView(
      children: <Widget>[
        Center(child: Text("You can upload here")),
        Center(child: Text("You can load data here")),
        Center(child: Text("Settings Page")),
      ],
    )
  );
}

方案二：使用自定义TabController并手动管理生命周期 #

如果需要在State内部控制Tab切换逻辑，推荐使用自定义控制器，并在dispose方法中销毁它：

class _MyHomePageState extends State<MyHomePage> with SingleTickerProviderStateMixin {
  late TabController _tabController;

  @override
  void initState() {
    super.initState();
    // 初始化控制器，传入vsync（需要混入SingleTickerProviderStateMixin）
    _tabController = TabController(length: 3, initialIndex: 1, vsync: this);
  }

  @override
  void dispose() {
    // 必须销毁控制器，避免内存泄漏和依赖问题
    _tabController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
        actions: [IconButton(icon: Icon(Icons.person), onPressed: (){})],
        bottom: TabBar(
          controller: _tabController, // 指定自定义控制器
          tabs: const <Widget>[
            Tab(icon: Icon(Icons.note_alt)),
            Tab(icon: Icon(Icons.list_alt)),
            Tab(icon: Icon(Icons.settings)),
          ],
        ),
      ),
      body: TabBarView(
        controller: _tabController, // 指定自定义控制器
        children: const <Widget>[
          Center(child: Text("You can upload here")),
          Center(child: Text("You can load data here")),
          Center(child: Text("Settings Page")),
        ],
      )
    );
  }
}

两种方案都能解决断言错误，选择哪种取决于你是否需要在代码中主动控制Tab的切换状态。

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