Flutter中AlertDialog调用LayoutConstraints触发LateInitializationError

问题原因 #

1. init方法多余的async修饰符：你的init方法内部没有任何异步逻辑，但标记了async，这会让方法返回Future，内部的变量赋值逻辑会被延迟到微任务队列执行。如果AlertDialog在这个延迟过程中被调用，就会触发未初始化错误。
2. 在build方法中执行初始化：build方法会因热重载、状态变化等多次执行，且无法等待异步方法完成，导致初始化时机不可控，可能出现变量未赋值就被调用的情况。

修复步骤 #

1. 移除init方法的async修饰符 #

方法内无异步操作，async完全多余，移除后能保证初始化逻辑同步执行：

void init(BuildContext context) {
  _mediaQueryData = MediaQuery.of(context);
  _width = _mediaQueryData!.size.width;
  _height = _mediaQueryData!.size.height - 30;
  _unitWidth = _mediaQueryData!.size.width / 100;
  _unitHeight = _mediaQueryData!.size.height / 100;
}

2. 在根Widget的initState中执行初始化 #

initState是Widget生命周期中仅执行一次的方法，适合做初始化操作，确保变量在Widget渲染前完成赋值：

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // 等待Widget构建完成后执行初始化，确保能获取到MediaQuery数据
    WidgetsBinding.instance.addPostFrameCallback((_) {
      LayoutConstraints().init(context);
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // 你的应用配置
    );
  }
}

3. 增加初始化校验（可选） #

为了在调试阶段快速定位问题，可在访问布局变量前增加断言校验：

double percentWidth(double percent) {
  assert(_unitWidth != null, "请先调用LayoutConstraints.init()完成初始化");
  return percent * _unitWidth;
}

double percentHeight(double percent) {
  assert(_unitHeight != null, "请先调用LayoutConstraints.init()完成初始化");
  return percent * _unitHeight;
}

额外优化建议 #

• 可以考虑使用InheritedWidget或MediaQuery扩展方法来管理布局参数，更符合Flutter的状态管理规范，避免单例带来的生命周期耦合问题。
• 永远不要在build方法中执行初始化、状态修改等副作用操作，build方法应该只负责纯渲染逻辑。

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