Smart Refresher在DefaultTabController与Slivers中无法正常工作

核心问题 #

SmartRefresher 直接嵌套 NestedScrollView 时，内部的滚动组件（比如 CustomScrollView）会优先捕获下拉手势，导致外层的 SmartRefresher 无法触发刷新回调。另外，代码里还存在 DefaultTabController 和自定义 _tabController 混用的潜在冲突，也会干扰滚动事件的正常传递。

修复步骤 #

1. 调整层级：将SmartRefresher移到每个Tab的滚动组件内部
   每个Tab对应的内容是独立滚动视图，应该给每个可滚动的Tab内容单独绑定下拉刷新，而非在外层包裹整个NestedScrollView。修改后核心代码如下：

   Scaffold(
     body: DefaultTabController(
       length: myTabs.length,
       child: NestedScrollView(  
         headerSliverBuilder: (context, innerBoxIsScrolled) {
           return [
             SliverToBoxAdapter(
               child: Container(
                 color: Constants.surface,
                 padding:
                     const EdgeInsets.symmetric(vertical: 14, horizontal: 20),
                 child: const Text("Header..."),
               ),
             ),
           ];
         },
         body: TabBarView(
           controller: _tabController,
           children: [
             // 给Tab1的滚动视图添加SmartRefresher
             SmartRefresher(
               header: const ClassicHeader(),
               footer: const ClassicFooter(),
               controller: refreshController1, // 建议每个Tab用独立的RefreshController
               onRefresh: _onRefreshTab1,
               onLoading: _onLoadingTab1,
               child: CustomScrollView(
                 slivers: [
                   SliverToBoxAdapter(
                     child: Tab1(),
                   ),
                 ],
               ),
             ),
             // 给Tab2的滚动视图添加SmartRefresher
             SmartRefresher(
               header: const ClassicHeader(),
               footer: const ClassicFooter(),
               controller: refreshController2,
               onRefresh: _onRefreshTab2,
               onLoading: _onLoadingTab2,
               child: CustomScrollView(
                 slivers: [
                   SliverToBoxAdapter(
                     child: Tab2(),
                   ),
                 ],
               ),
             ),
           ],
         ),
       ),
     ),
   );
   

2. 清理控制器冲突
   移除 DefaultTabController 和自定义 _tabController 的混用：要么只使用 DefaultTabController（无需手动创建_tabController），要么手动初始化_tabController并在dispose方法中销毁，避免逻辑混乱。

3. 正确初始化RefreshController
   在State类中为每个Tab单独初始化控制器，并在页面销毁时释放资源：

   late RefreshController refreshController1;
   late RefreshController refreshController2;
   
   @override
   void initState() {
     super.initState();
     refreshController1 = RefreshController(initialRefresh: false);
     refreshController2 = RefreshController(initialRefresh: false);
   }
   
   @override
   void dispose() {
     refreshController1.dispose();
     refreshController2.dispose();
     _tabController?.dispose(); // 若使用了自定义控制器需销毁
     super.dispose();
   }
   

4. 处理shrinkWrap的影响
   Tab2中CustomScrollView的shrinkWrap: true会让视图高度自适应内容，若内容不足一屏，下拉手势可能无法被触发。建议移除该属性，或确保Tab2内容足够长，或给外层添加固定高度约束。

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