返回首页时Scroll View报错：ScrollController被绑定至多个滚动视图

算力阿峰

2026-4-27

解决ScrollController绑定多个滚动视图的异常问题

我来帮你分析下这个问题——从你提供的错误日志可以明确看到核心症结：ScrollController attached to multiple scroll views，也就是你的PageController（它继承自ScrollController）被同时绑定到了多个滚动组件（这里应该是PageView），触发了Flutter框架的断言检查_positions.length == 1，导致返回首页后无法正常滚动。

问题根源拆解

从调用栈能追踪到，异常是在点击分类轮播组件（_CategoriesCarousel）后，调用ServicesProvider.selectCategory里的PageController.animateToPage方法时抛出的。这说明你的PageController实例被重复绑定了：要么是页面返回首页时，旧的PageView没有正确销毁，残留的绑定关系还存在；要么是Controller实例被全局复用，新创建的PageView又绑定了同一个Controller。

具体解决方案

1. 给每个滚动组件分配独立的Controller实例

绝对不要在多个PageView/ScrollView之间复用同一个Controller。如果你的Controller之前是在ServicesProvider中全局管理的，建议改为在对应页面的State中创建局部Controller，严格绑定页面生命周期：

class _HomePageState extends State<HomePage> {
  late PageController _pageController;

  @override
  void initState() {
    super.initState();
    // 页面初始化时创建专属的Controller
    _pageController = PageController();
  }

  @override
  void dispose() {
    // 页面销毁时释放Controller，清除绑定关系
    _pageController.dispose();
    super.dispose();
  }

  // 在需要跳转页面时，直接使用这个局部Controller
  void _handleCategoryTap(int index) {
    _pageController.animateToPage(
      index,
      duration: const Duration(milliseconds: 300),
      curve: Curves.easeInOut,
    );
  }
}

2. 全局Controller需配合生命周期重置

如果必须在Provider中管理Controller，一定要在页面退出时重置或销毁实例，避免残留绑定：

class ServicesProvider extends ChangeNotifier {
  PageController? _pageController;

  PageController get pageController => _pageController ??= PageController();

  // 页面离开时调用此方法，重置Controller
  void resetPageController() {
    _pageController?.dispose();
    _pageController = PageController();
    notifyListeners();
  }

  void selectCategory(int index) {
    _pageController?.animateToPage(
      index,
      duration: const Duration(milliseconds: 300),
      curve: Curves.easeInOut,
    );
  }
}

然后在首页的dispose或deactivate方法中调用resetPageController，确保返回首页时Controller是全新的实例。

3. 检查页面路由的销毁逻辑

如果使用Navigator.push跳转页面，返回首页时要确认旧页面实例是否被正确销毁（可以在页面的dispose方法中打印日志验证）。如果页面没有被销毁，残留的PageView会一直绑定着Controller，导致新页面的PageView绑定后触发异常。

错误日志原文

========= 手势捕获到异常 =================================================================
处理手势时抛出以下断言：
ScrollController attached to multiple scroll views.
'package:flutter/src/widgets/scroll_controller.dart': 断言失败：第108行第12位: '_positions.length == 1'
该断言要么表明框架本身存在错误，要么我们应在此错误消息中提供更多信息以帮助您确定并修复根本原因。无论哪种情况，请通过在GitHub提交bug报告此断言：https://github.com/flutter/flutter/issues/new?template=2_bug.md
抛出异常时的调用栈：
#2 ScrollController.position (package:flutter/src/widgets/scroll_controller.dart:108:12)
#3 PageController.animateToPage (package:flutter/src/widgets/page_view.dart:197:41)
#4 ServicesProvider.selectCategory (package:agenda_booking/providers/servides_provider.dart:73:21)
#5 _CategoriesCarousel.build.. (package:agenda_booking/pages/home_page.dart:212:45)
#6 _InkResponseState._handleTap (package:flutter/src/material/ink_well.dart:1005:21)
#7 GestureRecognizer.invokeCallback (package:flutter/src/gestures/recognizer.dart:198:24)
#8 TapGestureRecognizer.handleTapUp (package:flutter/src/gestures/tap.dart:613:11)
#9 BaseTapGestureRecognizer._checkUp (package:flutter/src/gestures/tap.dart:298:5)
#10 BaseTapGestureRecognizer.acceptGesture (package:flutter/src/gestures/tap.dart:269:7)
#11 GestureArenaManager.sweep (package:flutter/src/gestures/arena.dart:157:27)
#12 GestureBinding.handleEvent (package:flutter/src/gestures/binding.dart:449:20)
#13 GestureBinding.dispatchEvent (package:flutter/src/gestures/binding.dart:425:22)
#14 RendererBinding.dispatchEvent (package:flutter/src/rendering/binding.dart:329:11)
#15 GestureBinding._handlePointerEventImmediately (package:flutter/src/gestures/binding.dart:380:7)
#16 GestureBinding.handlePointerEvent (package:flutter/src/gestures/binding.dart:344:5)
#17 GestureBinding._flushPointerEventQueue (package:flutter/src/gestures/binding.dart:302:7)
#18 GestureBinding._handlePointerDataPacket (package:flutter/src/gestures/binding.dart:285:7)
#22 _invoke1 (dart:ui/hooks.dart:170:10)
#23 PlatformDispatcher._dispatchPointerDataPacket (dart:ui/platform_dispatcher.dart:331:7)
#24 _dispatchPointerDataPacket (dart:ui/hooks.dart:94:31)
（省略了来自_AssertionError和dart:async的5个调用栈帧）
Handler: "onTap"
Recognizer: TapGestureRecognizer#340e5
debugOwner: GestureDetector
state: ready
won arena
finalPosition: Offset(105.0, 340.0)
finalLocalPosition: Offset(20.0, 42.0)
button: 1
sent tap down.

内容的提问来源于stack exchange，提问作者Diego Andres Rojas Vera