Flutter嵌套StatefulWidget时子组件未同步父组件更新参数问题

日志能打印出最新的_timerDuration值但界面始终显示初始值10，核心原因是CustomTimer作为StatefulWidget的状态复用机制：

1. 它内部的begin属性虽然是final类型，但组件对应的State实例只会在首次挂载到Widget树时初始化，初始化时读取第一次传入的begin值（也就是初始的10秒）存在自身的状态变量中
2. 后续父组件setState触发重建时，因为你传入的_controller实例不变、组件类型不变、也没有设置Key，Flutter会直接复用已有的CustomTimer State实例，不会重新读取新传入的begin值更新计时状态，所以界面始终显示初始时长。

两种方案二选一即可：

• 方案1：加ValueKey强制时长变更时重建组件（仅修改父组件即可，无需改动CustomTimer源码）
  给CustomTimer传入绑定_timerDuration的ValueKey，时长变化时Flutter会判定该位置的组件需要更新，自动销毁旧State、创建新State读取新的begin值。
  对应修改buildTimerWidget方法：

  Widget buildTimerWidget() {
    print("build timer with duration: ${_timerDuration}");
    return CustomTimer(
        key: ValueKey(_timerDuration), // 新增这行
        controller: _controller,
        begin: Duration(seconds: _timerDuration),
        end: const Duration(),
        builder: (time) {
          return Text("${time.minutes}:${time.seconds}",
              style: kLabelTextStyle);
        });
  }
  

  注意：用这个方案需要在更新时长前先调用_controller.reset()清空旧的计时状态，避免残留状态导致计时异常。

• 方案2：实现didUpdateWidget生命周期响应参数变化（性能更优，推荐）
  如果你可以修改CustomTimer的源码，在其State类中重写didUpdateWidget方法，监听父组件传入的begin值变化，手动更新内部计时状态即可，不需要销毁重建组件：

  // 在_CustomTimerState中添加以下代码
  @override
  void didUpdateWidget(covariant CustomTimer oldWidget) {
    super.didUpdateWidget(oldWidget);
    if (widget.begin != oldWidget.begin) {
      // 重置控制器
      controller.reset();
      // 更新State中存储的计时初始值为新传入的begin
      currentDuration = widget.begin;
      // 按需重新启动计时
      controller.start();
    }
  }
  

你现在读取SharedPreferences时用了强制解包prefs.getInt("timer_duration")!，首次启动APP没有存储对应值时会触发空指针崩溃，建议加默认值兜底：

_timerDuration = prefs.getInt("timer_duration") ?? 10;

另外不建议在setState回调里直接调用_controller.start()，setState执行时build流程还没完成，此时控制器可能还绑定在旧的组件State上，容易出现状态错乱，建议把启动逻辑放到组件初始化/参数更新的回调里。

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