Flutter布局错误：无法获取未完成布局的RenderObject尺寸

错误原因分析 #

你遇到的FlutterError核心原因是：在渲染对象完成布局流程前，代码尝试获取了RenderCustomPaint的尺寸。错误栈指向自定义绘制器_LinearPainter，说明问题出在该绘制器的实现或调用时机上——通常是在build阶段（而非布局完成后）尝试获取渲染对象尺寸，或是在绘制逻辑中错误地通过GlobalKey获取未完成布局的组件尺寸。

具体解决方案 #

1. 修正自定义绘制器_LinearPainter的实现 #

如果_LinearPainter需要使用组件尺寸，不要通过GlobalKey获取RenderCustomPaint的尺寸，直接使用绘制方法传入的size参数即可（该参数在绘制阶段已确定为最终布局尺寸）：

错误写法示例：

class _LinearPainter extends CustomPainter {
  final GlobalKey customPaintKey;

  _LinearPainter(this.customPaintKey);

  @override
  void paint(Canvas canvas, Size size) {
    // 错误：布局未完成时通过GlobalKey获取尺寸
    final renderObj = customPaintKey.currentContext?.findRenderObject() as RenderCustomPaint;
    final paintSize = renderObj.size;
    // ... 绘制逻辑
  }

  @override
  bool shouldRepaint(covariant CustomPainter oldDelegate) => true;
}

正确写法：

class _LinearPainter extends CustomPainter {
  @override
  void paint(Canvas canvas, Size size) {
    // 直接使用paint方法传入的size，这是已确定的布局尺寸
    final paintSize = size;
    // ... 你的绘制逻辑
  }

  @override
  bool shouldRepaint(covariant CustomPainter oldDelegate) => true;
}

2. 延迟获取尺寸到布局完成后 #

如果确实需要在布局完成后获取CustomPaint的尺寸，不要在build阶段调用，而是通过WidgetsBinding的addPostFrameCallback在布局完成后的回调中获取：

// 在StatefulWidget的initState中添加回调
@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    final renderObj = customPaintKey.currentContext?.findRenderObject() as RenderCustomPaint;
    final size = renderObj.size;
    // 在这里使用尺寸执行后续逻辑
  });
}

3. 优化SignInView的尺寸获取逻辑 #

你当前使用MediaQuery.of(context).size获取屏幕尺寸设置按钮宽度，可替换为LayoutBuilder获取父组件的约束尺寸，避免布局阶段的尺寸冲突：

修改后的SignInView代码：

class SignInView extends StatelessWidget {
  const SignInView({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Padding(
        padding: const EdgeInsets.all(10.0),
        child: LayoutBuilder(
          builder: (context, constraints) {
            return Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Expanded(
                  child: SizedBox(
                    width: 200,
                    height: 200,
                    child: Image.asset('assets/logo/myliblogo.png'),
                  ),
                ),
                ElevatedButton(
                  onPressed: () {
                    Navigator.of(context).pushReplacementNamed('/');
                  },
                  style: ButtonStyle(
                    backgroundColor: MaterialStateProperty.all(
                      const Color(0xff273043),
                    ),
                    minimumSize: MaterialStateProperty.all(
                      Size(constraints.maxWidth, 40),
                    ),
                  ),
                  child: Text(
                    'Google',
                    style: Theme.of(context)
                        .textTheme
                        .bodyLarge!
                        .copyWith(color: Colors.white),
                  ),
                ),
                const SizedBox(height: 12),
              ],
            );
          },
        ),
      ),
    );
  }
}

内容的提问来源于stack exchange，提问作者Doğukan Özgür YILMAZ