Flutter跨页面重定向后回调函数未触发问题解决方案

涉及的核心业务代码如下：
HomeScreen及嵌套子组件实现：

import 'package:flutter/material.dart';

class HomeScreen extends StatefulWidget {
  const HomeScreen({Key? key}) : super(key: key);

  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  @override
  Widget build(BuildContext context) {
    return Container(child: ChildOne(someFunction: someFunction));
  }

  someFunction(dateTime) {
    // 业务处理逻辑
  }
}

class ChildOne extends StatefulWidget {
  const ChildOne({Key? key, this.someFunction}) : super(key: key);
  final Function? someFunction;

  @override
  State<ChildOne> createState() => _ChildOneState();
}

class _ChildOneState extends State<ChildOne> {
  @override
  Widget build(BuildContext context) {
    return Container(
      child: ChildTwo(someFunction: widget.someFunction),
    );
  }
}

class ChildTwo extends StatefulWidget {
  const ChildTwo({Key? key, this.someFunction}) : super(key: key);
  final Function? someFunction;

  @override
  State<ChildTwo> createState() => _ChildTwoState();
}

class _ChildTwoState extends State<ChildTwo> {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance!.addPostFrameCallback((_) =>
        (widget.someFunction != null)
            ? widget.someFunction!(DateTime.now())
            : () {});
  }

  @override
  Widget build(BuildContext context) {
    return Container();
  }

  someOtherFunction() {
    widget.someFunction!(DateTime.now());
  }
}

• 异常表现：HomeScreen首次加载时所有功能运行正常，从其他页面重定向跳转至HomeScreen后，定义的someFunction回调无法被触发。
• 跳转逻辑位于SomeOtherScreen页面，API调用完成后的跳转代码如下：

///After an API call....

if (response.statusCode == 200) {
  Navigator.popAndPushNamed(context, MyRoutes.homeRoute);
} 

该逻辑为接口返回200状态码时，调用Navigator.popAndPushNamed方法跳转至命名路由MyRoutes.homeRoute。

popAndPushNamed的执行逻辑是先弹出当前路由，再推入目标路由。如果路由栈中此前已经存在HomeScreen实例，Flutter默认会复用对应的State对象，不会重新执行initState生命周期。当前代码将someFunction的触发逻辑写在ChildTwo的initState中，路由复用时该段逻辑不会执行，直接导致回调不触发。
此外现有代码存在两个兼容隐患：

• WidgetsBinding.instance!的强制解包写法在Flutter 3.0及以上版本易触发空安全报错
• 回调的空判断逻辑存在冗余，无效空函数写法没有实际意义

按以下步骤调整即可解决问题：

1. 覆写didUpdateWidget生命周期，补充组件更新时的回调触发逻辑，同时抽离公共的回调触发方法消除冗余代码。修改后的_ChildTwoState代码如下：

class _ChildTwoState extends State<ChildTwo> {
  @override
  void initState() {
    super.initState();
    // 保留首次加载时的触发逻辑
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _runCallback();
    });
  }

  // 组件更新时检测传入回调的变化，主动触发
  @override
  void didUpdateWidget(covariant ChildTwo oldWidget) {
    super.didUpdateWidget(oldWidget);
    if (oldWidget.someFunction != widget.someFunction) {
      WidgetsBinding.instance.addPostFrameCallback((_) {
        _runCallback();
      });
    }
  }

  // 抽离公共回调触发方法，统一做空安全判断
  void _runCallback() {
    final func = widget.someFunction;
    if (func != null) {
      func(DateTime.now());
    }
  }

  @override
  Widget build(BuildContext context) {
    return Container();
  }

  someOtherFunction() {
    _runCallback();
  }
}

2. 如果业务要求每次跳转到HomeScreen都重置整个页面状态，可以在注册路由时给HomeScreen设置全局唯一ValueKey，保证每次路由推入都会生成新的State实例。注意这种方式会清空HomeScreen及其子组件的所有本地状态，需要根据业务场景选择使用。

提示：Flutter 3.0及以上版本中WidgetsBinding.instance已经是默认非空属性，不需要添加强制解包的!符号，避免运行时异常。

内容的提问来源于stack exchange，提问作者who-aditya-nawandar