Flutter setState后PageView忽略PageController.page属性跳回首页问题

这个异常的核心诱因是组件重建时控制器状态丢失：

• 你通过setState修改dismissDirection时会触发整个组件树重建，如果PageController是在build方法内临时创建的，每次重建都会生成全新的控制器实例，新实例默认初始页码为0，就会直接跳回第一页。
• 你之前尝试的AutomaticKeepAliveClientMixin仅负责保留已渲染页面的内部状态，无法解决控制器被重新创建导致的页码重置问题，自然不会生效。
• 如果PageView的子项（外层包裹的Dismissible组件）没有设置稳定的唯一Key，Flutter在重建时无法正确匹配当前选中的页面位置，也会加剧页码跳转的异常。

按以下步骤修改即可解决问题：

• 在对应组件的State类中提前声明、初始化PageController实例，不要在build方法内创建控制器，保证整个组件生命周期内复用同一个控制器实例，同时在组件销毁时调用dispose方法释放资源。
• 给PageView的每一个子项（即外层的Dismissible组件）绑定稳定的唯一Key（比如和图片索引、资源id绑定的ValueKey），不要在build时生成随机Key，保证Flutter重建时能正确识别页面位置。
• 可选优化：用ValueNotifier持有图片缩放状态，配合ValueListenableBuilder仅局部更新Dismissible的direction属性，避免缩放状态变化时触发整个PageView重建，既减少性能损耗，也能从根源避免不必要的组件刷新。

参考实现代码：

class _EasyImageViewerState extends State<EasyImageViewer> {
  // 全局持有同一个PageController实例
  late final PageController _pageController;
  // 用ValueNotifier持有滑动方向配置，避免全量重建
  final ValueNotifier<DismissDirection> _dismissDirectionNotifier = 
      ValueNotifier(DismissDirection.down);

  @override
  void initState() {
    super.initState();
    _pageController = PageController(initialPage: widget.initialIndex);
  }

  @override
  void dispose() {
    _pageController.dispose();
    _dismissDirectionNotifier.dispose();
    super.dispose();
  }

  // 图片缩放状态变化回调
  void _handleZoomStateChanged(bool isZoomed) {
    _dismissDirectionNotifier.value = isZoomed 
        ? DismissDirection.none 
        : DismissDirection.down;
  }

  @override
  Widget build(BuildContext context) {
    return PageView.builder(
      controller: _pageController,
      itemCount: widget.images.length,
      itemBuilder: (context, index) {
        return ValueListenableBuilder<DismissDirection>(
          valueListenable: _dismissDirectionNotifier,
          builder: (context, direction, child) {
            return Dismissible(
              // 绑定稳定的唯一Key
              key: ValueKey('easy_image_${widget.images[index].id}'),
              direction: direction,
              onDismissed: (_) => Navigator.pop(context),
              child: child!,
            );
          },
          child: InteractiveViewer(
            // 图片组件，缩放回调触发_handleZoomStateChanged
            onInteractionEnd: (details) {
              // 判断当前缩放比例是否大于1，更新滑动禁用状态
              _handleZoomStateChanged(/* 缩放判断逻辑 */);
            },
            child: Image(image: widget.images[index].image),
          ),
        );
      },
    );
  }
}

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