Flutter初始化StatefulWidget时触发LateInitializationError报错

• 报错核心是你对StatefulWidget的生命周期理解有误：createState() 是Flutter框架在组件首次挂载到Widget树时才会自动调用的方法，不是你执行CustomAppLoader loader=CustomAppLoader();实例化Widget的时候就会触发。
• 你在Widget类里定义的late final _customAppLoaderState字段，赋值逻辑写在createState()方法内，实例化Widget后立刻调用setProgressPerc()时，createState()还没执行，字段根本没完成初始化，自然抛出LateInitializationError。
• 额外问题：手动在Widget类中持有State实例、从外部直接调用State的setState方法是Flutter开发的反模式，很容易触发组件未挂载时调用setState、空指针、内存泄漏等问题。

1. 重构CustomAppLoader组件，删除手动持有State的错误逻辑 #

不要手动缓存State实例，通过Flutter框架提供的方式对外暴露State访问能力，修正后的CustomAppLoader类代码如下：

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

  // 提供标准of方法供外部获取关联的State实例
  static _CustomAppLoaderState? of(BuildContext context) {
    return context.findAncestorStateOfType<_CustomAppLoaderState>();
  }

  @override
  State<CustomAppLoader> createState() => _CustomAppLoaderState();
}

2. 修复State类中的潜在空指针问题 #

你原本的取消按钮逻辑存在强制非空断言风险，同时组件销毁后调用导航会报错，修正对应代码：

// 仅修正问题部分，其余build逻辑保持不变
Visibility(
  visible: isCancelButtonVisible,
  child: TextButton(onPressed: (){
    // 先判空，避免_cancelToken为null时抛异常
    if(_cancelToken == null) return;
    _cancelToken!.cancel();
    if(_cancelToken!.isCancelled) {
      // 增加mounted判断，组件已销毁时不执行导航操作
      if(mounted) Navigator.pop(context);
    }
  }, child: Text(AppLocalizations.of(context)!.cancel, style: AppTextStyle.whiteOnBlackSmallWhite(context),), ),
)

3. 修正调用方式 #

StatefulWidget必须先挂载到Widget树才能正常访问State，不能实例化后不渲染就直接调用方法，正确调用示例：

• 第一步：在页面布局中把CustomAppLoader加入组件树，一般放在全屏遮罩层位置：

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: Stack(
      children: [
        // 页面原有业务内容
        const Positioned.fill(child: CustomAppLoader()),
      ],
    ),
  );
}

• 第二步：需要控制加载器时，通过上下文拿到State再操作：

// 显示加载器
CustomAppLoader.of(context)?.setVisibility(true);
// 更新进度
CustomAppLoader.of(context)?.setProgressValue(progress: 0.25);
// 设置取消token
CustomAppLoader.of(context)?.setCancelToken(cancelToken: 你的CancelToken实例);

如果你的组件层级比较复杂，通过context找State不方便，也可以用GlobalKey的方式获取State，但要注意GlobalKey的全局唯一性，不要滥用。更推荐的复杂场景下状态控制方案是使用成熟的状态管理库（比如Provider、Riverpod、Bloc），不要手动维护组件实例和状态的引用关系。

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