Flutter页面跳转后PageController未初始化问题求助

问题根源 #

1. 错误的Provider实例调用：在initState中直接ProviderData().loadFromPrefs()会创建全新的Provider实例，和全局注册的实例无关，既拿不到正确缓存数据，又因异步加载延迟导致页面build时controller未初始化。
2. Provider构造函数异步逻辑缺陷：ProviderData构造函数调用的loadFromPrefs()是异步操作，但构造函数本身无法使用async，导致页面初始化时_pageIndex可能还未从SharedPreferences加载完成。
3. Late变量初始化时机冲突：late final PageController controller要求使用前必须完成初始化，但异步加载回调在initState之后执行，页面首次build时controller还未赋值，直接触发错误。

修复步骤 #

1. 修正ProviderData的初始化逻辑 #

调整构造函数的异步加载方式，确保索引数据及时加载并通知监听者：

import 'package:flutter/cupertino.dart';
import 'package:shared_preferences/shared_preferences.dart';

class ProviderData extends ChangeNotifier {
  SharedPreferences? prefs;
  final String pageIndexKey = 'pageIndex';
  int _pageIndex = 0; // 设默认值，避免可空类型问题

  ProviderData() {
    // 用Future.microtask确保构造函数执行完后再启动异步加载
    Future.microtask(() => loadFromPrefs());
  }

  Future<void> _initPrefs() async {
    prefs ??= await SharedPreferences.getInstance();
  }

  Future<void> loadFromPrefs() async {
    await _initPrefs();
    final savedIndex = prefs!.getInt(pageIndexKey) ?? 0;
    if (_pageIndex != savedIndex) { // 避免无意义的通知
      _pageIndex = savedIndex;
      notifyListeners();
    }
  }

  Future<void> _savePageIndexToPrefs({required String key, required int value}) async {
    await _initPrefs();
    await prefs!.setInt(key, value); // 加await确保保存操作完成
  }

  void changePageIndex(int newPageIndex) {
    if (_pageIndex != newPageIndex) {
      _pageIndex = newPageIndex;
      _savePageIndexToPrefs(key: pageIndexKey, value: _pageIndex);
      notifyListeners();
    }
  }

  // 新增getter，让外部能直接获取当前索引
  int get pageIndex => _pageIndex;
}

2. 修正PageViewScreen的控制器初始化 #

直接通过全局Provider获取已加载的索引，避免异步初始化时机问题：

class PageViewScreen extends StatefulWidget {
  const PageViewScreen({super.key});

  @override
  State<PageViewScreen> createState() => _PageViewScreenState();
}

class _PageViewScreenState extends State<PageViewScreen> {
  late final PageController controller;

  @override
  void initState() {
    super.initState();
    // 从全局Provider获取初始索引，此时Provider已完成数据加载
    final providerData = Provider.of<ProviderData>(context, listen: false);
    controller = PageController(initialPage: providerData.pageIndex);
  }

  @override
  void dispose() {
    controller.dispose(); // 记得销毁控制器，避免内存泄漏
    super.dispose();
  }

  // ... 你的其他页面代码

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // ... 页面其他结构
      body: Consumer<ProviderData>(
        builder: (context, providerData, child) {
          return PageView(
            controller: controller,
            onPageChanged: (index) {
              providerData.changePageIndex(index);
              setState(() {
                onLastPage = index == 2;
                onFirstPage = index == 0;
                onSecondPage = index == 1;
                onThirdPage = index == 2;
                onFourthPage = index == 3;
                onFifthPage = index == 4;
                onSixthPage = index == 5;
                onSeventhPage = index == 6;
              });
            },
            children: _pageList,
          );
        },
      ),
    );
  }
}

3. 确保Provider全局注册 #

必须在MaterialApp外层注册Provider，保证所有页面共享同一个实例：

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (context) => ProviderData(),
      child: const MyApp(),
    ),
  );
}

额外优化建议 #

• 可以在PageViewScreen的build方法中监听Provider的pageIndex变化，若外部修改了索引，可调用controller.jumpToPage(providerData.pageIndex)同步页面位置。
• 去掉onPageChanged中冗余的setState，直接用providerData.pageIndex判断当前页面，无需维护多个布尔变量。

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