测试继承StatelessWidget的按钮时遇ScreenUtil未初始化错误

问题背景 #

测试继承自抽象类LoginButton的组件（如GoogleLoginButton）时，触发ScreenUtil的LateInitializationError: Field '_splitScreenMode@488084504' has not been initialized.。已通过ScreenUtilInit包裹测试组件，但仅继承类出现该问题，移除24.h/24.w这类单位后测试恢复正常。

可行解决方案 #

1. 测试前置手动初始化ScreenUtil

直接在测试用例的setUp阶段初始化ScreenUtil，跳过Widget树的生命周期依赖，适用于所有继承组件的测试场景：

import 'package:flutter_screenutil/flutter_screenutil.dart';
import 'package:flutter_test/flutter_test.dart';

void main() {
  setUp(() {
    // 提前初始化ScreenUtil，参数和项目中保持一致
    ScreenUtil.init(
      const BoxConstraints(),
      designSize: const Size(375, 812), // 替换成你的设计稿尺寸
      orientation: Orientation.portrait,
    );
  });

  testWidgets('GoogleLoginButton renders correctly', (tester) async {
    await tester.pumpWidget(const GoogleLoginButton());
    // 这里写你的断言逻辑，比如查找按钮、验证尺寸等
  });
}

原理：继承组件可能在Widget树完成构建前就访问了ScreenUtil的静态属性，手动提前初始化能直接覆盖这种场景，无需依赖ScreenUtilInit的Widget生命周期。

2. 强化测试Wrapper的上下文环境

如果必须依赖Widget树初始化，把ScreenUtilInit嵌套在MaterialApp中，确保完整的上下文初始化顺序：

Widget createTestableWidget(Widget child) {
  return MaterialApp(
    home: ScreenUtilInit(
      designSize: const Size(375, 812),
      builder: (context, child) => child!,
      child: child,
    ),
  );
}

testWidgets('GoogleLoginButton renders correctly', (tester) async {
  await tester.pumpWidget(createTestableWidget(const GoogleLoginButton()));
  // 断言逻辑
});

原理：MaterialApp会提供完整的Flutter上下文环境，确保ScreenUtilInit的builder方法优先完成初始化，再渲染继承的LoginButton组件。

3. 给抽象类添加初始化钩子

如果所有继承自LoginButton的组件都依赖ScreenUtil，可以在抽象类中添加静态初始化方法，统一处理测试前的初始化：

abstract class LoginButton extends StatelessWidget {
  static void ensureScreenUtilInitialized() {
    if (!ScreenUtil.isInit) {
      ScreenUtil.init(
        const BoxConstraints(),
        designSize: const Size(375, 812),
      );
    }
  }

  // 你的抽象方法，比如：
  void onLoginPressed();
}

然后在测试的setUp中调用：

setUp(() {
  LoginButton.ensureScreenUtilInitialized();
});

原理：统一管理所有继承组件的ScreenUtil初始化，避免重复代码，同时确保测试前必完成初始化。

4. 排查继承组件的变量初始化时机

检查继承组件是否在类成员变量定义阶段就直接使用24.h/24.w，比如：

// ❌ 错误：实例化类时就访问ScreenUtil，此时未初始化
class GoogleLoginButton extends LoginButton {
  final double iconSize = 24.h;

  @override
  Widget build(BuildContext context) {
    return Icon(Icons.g_mobiledata, size: iconSize);
  }
}

改成在build方法内计算：

// ✅ 正确：build方法执行时，ScreenUtil已完成初始化
class GoogleLoginButton extends LoginButton {
  @override
  Widget build(BuildContext context) {
    final double iconSize = 24.h;
    return Icon(Icons.g_mobiledata, size: iconSize);
  }
}

原理：类成员变量的初始化时机早于Widget树的构建，此时ScreenUtil还未初始化，移到build方法内即可避免错误。

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