Flutter中DefaultTabController.of始终返回null问题求助

核心原因 #

DefaultTabController.of(context) 返回 null，本质是你调用这个方法时用的context不在DefaultTabController的子Widget树范围内，或者context对应的Widget和DefaultTabController是同级/父级关系，导致无法向上查找到对应的控制器实例。

具体场景及解决办法 #

1. 调用位置的Context不属于DefaultTabController子树 #

比如你的结构是这样的：

Scaffold(
  body: Column(
    children: [
      DefaultTabController(
        length: 2,
        child: TabBar(tabs: [Tab(text: "Tab1"), Tab(text: "Tab2")]),
      ),
      ElevatedButton(
        onPressed: () {
          // 这里的context是Scaffold的context，和DefaultTabController同级，找不到
          var c = DefaultTabController.of(context);
          print(c); // null
        },
        child: Text("获取控制器"),
      )
    ],
  ),
)

解决办法：把需要调用of(context)的Widget放到DefaultTabController的子树里，或者用Builder包裹来获取子树的context：

DefaultTabController(
  length: 2,
  child: Column(
    children: [
      TabBar(tabs: [Tab(text: "Tab1"), Tab(text: "Tab2")]),
      Builder(
        builder: (context) {
          return ElevatedButton(
            onPressed: () {
              var c = DefaultTabController.of(context); // 这里能拿到
              print(c);
            },
            child: Text("获取控制器"),
          );
        },
      )
    ],
  ),
)

2. 在Widget初始化阶段（比如initState）调用 #

initState执行时，Widget还没挂载到树上，DefaultTabController还没和当前context建立关联，此时调用of(context)必然返回null。
解决办法：延迟到Widget挂载完成后调用，比如用WidgetsBinding.instance.addPostFrameCallback：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    var c = DefaultTabController.of(context);
    if (c != null) {
      // 这里可以正常使用控制器
    }
  });
}

3. 错误地使用了GlobalKey或者无关的Context #

如果你手动传了其他地方的context（比如父Widget的globalKey.currentContext），也可能导致找不到。确保你用的context是当前Widget在DefaultTabController子树内的BuildContext。

4. DefaultTabController未正确初始化 #

检查你的DefaultTabController是否设置了length属性，并且确实作为父Widget包裹了TabBar/TabView等组件，没有被其他Widget（比如Navigator）隔断上下文关联。

替代方案 #

如果上述方法都不方便，可以手动创建TabController并通过构造函数传递，这样更可控：

class _MyPageState extends State<MyPage> with SingleTickerProviderStateMixin {
  late TabController _tabController;

  @override
  void initState() {
    super.initState();
    _tabController = TabController(length: 2, vsync: this);
  }

  @override
  void dispose() {
    _tabController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: TabBar(controller: _tabController, tabs: [...]),
    );
  }
}

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