Flutter中addPostFrameCallback持续执行如何实现仅运行一次

你遇到的两个问题本质都是Flutter生命周期和异步时序不匹配导致的：

• initState()取值不稳定：SharedPreferences实例获取是异步IO操作，initState执行时不会等待异步任务完成就会继续推进帧渲染流程，如果异步任务在首帧build之后才返回，首帧渲染拿到的就是未初始化的默认值，表现为取值结果不稳定。
  
  你当前的取值方法都是每次调用时异步获取实例，会进一步放大时序不一致的问题：
  
• addPostFrameCallback半秒重复执行：这个回调仅在注册后的下一帧绘制完成时触发一次，你当前的实现没有做单次执行拦截，回调中触发setState会导致组件重建，重建过程中如果又重新注册了该回调，就会形成「注册回调→回调执行→setState重建→重新注册回调」的死循环，表现为固定间隔反复执行。
  

按照稳定性优先级从高到低推荐以下实现：

方案1：应用启动前完成全局初始化（最推荐） #

彻底规避组件生命周期和异步任务的时序冲突，是官方推荐的SharedPreferences使用方式：

void main() async {
  // 初始化Flutter引擎绑定
  WidgetsFlutterBinding.ensureInitialized();
  // 应用启动前一次性完成SharedPreferences初始化，需要的值可以在这里提前读取、调整
  final SharedPreferences prefs = await SharedPreferences.getInstance();
  // 调整值的逻辑直接在这里同步执行即可
  // if(需要调整的条件) prefs.setXxx(key, newValue);
  // 将初始化完成的prefs实例通过全局单例/Provider/InheritedWidget注入到整个应用
  runApp(MyApp(prefs: prefs));
}

后续所有页面取值都直接使用已经初始化完成的prefs实例做同步读取，不需要再写异步等待逻辑，完全不会出现取值不稳定的问题。

方案2：组件内初始化加单次执行锁 #

如果受项目架构限制无法在main函数提前初始化，使用addPostFrameCallback时必须加执行状态标记，阻断死循环：

class _YourPageState extends State<YourPage> {
  bool _isInitExecuted = false;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((timeStamp) async {
      // 已经执行过初始化直接返回，避免重复触发
      if (_isInitExecuted) return;

      final prefs = await SharedPreferences.getInstance();
      // 在这里执行值读取、调整逻辑
      // 赋值给对应的状态变量

      if (mounted) {
        setState(() {
          _isInitExecuted = true;
        });
      }
    });
  }
}

方案3：FutureBuilder管理加载状态 #

如果加载阶段需要展示加载占位组件，可以使用FutureBuilder管理异步状态，注意要在initState里初始化异步任务，避免build阶段重复创建Future导致重复执行：

class _YourPageState extends State<YourPage> {
  late final Future<SharedPreferences> _prefsInitFuture;

  @override
  void initState() {
    super.initState();
    // 仅初始化一次异步任务
    _prefsInitFuture = SharedPreferences.getInstance();
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: _prefsInitFuture,
      builder: (context, snapshot) {
        // 未加载完成时展示loading
        if (!snapshot.hasData) {
          return const Center(child: CircularProgressIndicator());
        }
        final prefs = snapshot.data!;
        // 在这里读取、调整配置值，返回正常页面组件
        return YourPageContent();
      },
    );
  }
}

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