Flutter如何修复Null check operator used on a null value报错

• 触发场景：点击页面内「edit item」选项时直接抛出代码异常
• 核心报错信息：

构建FormBuilderField（脏状态，依赖项包含[_FormScope、UnmanagedRestorationScope]，状态为FormBuilderFieldState<FormBuilderField, int>#e0024）时抛出_CastError：Null check operator used on a null value

• 报错定位：关联异常组件为FormBuilderField，对应代码行：lib/src/widgets/selected_ngo_widget.dart:23:12

问题相关代码 #

class SelectedNgo extends StatefulWidget {
  int? id;
  String? name;
  String? logo;
  int? defaultValue;
  final GlobalKey<FormBuilderState> formKey;

  SelectedNgo(this.formKey, {this.defaultValue, this.name, this.logo, this.id, Key? key})
      : super(key: key);

  @override
  State<SelectedNgo> createState() => _SelectedNgoState();
}

class _SelectedNgoState extends State<SelectedNgo> {
  @override
  Widget build(BuildContext context) {
    return FormBuilderField(
        name: 'ngoId',
        initialValue: widget.id,
        builder: (FormFieldState<int> field) {
          return Form(
            child: Card(
              child: Row(
                children: [
                  const SizedBox(
                    width: 10,
                  ),
                  Padding(
                    padding: const EdgeInsets.all(10),
                    child: CachedNetworkImage(
                      imageUrl: '${widget.logo}_SMALL.jpg',
                      placeholder: (context, url) => const CircularProgressIndicator(),
                      errorWidget: (context, url, error) => const Icon(Icons.error),
                      height: 80,
                      fit: BoxFit.contain,
                    ),
                  ),
                  Expanded(
                      child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      Text(
                        widget.name!,
                        textAlign: TextAlign.center,
                        style: GoogleFonts.k2d(
                          textStyle: const TextStyle(
                            fontWeight: FontWeight.w600,
                            fontSize: 14,
                            color: Colors.black,
                          ),
                        ),
                      ),
                    ],
                  ))
                ],
              ),
            ),
          );
        });
  }
}

问题原因 #

报错由三类问题共同触发：

1. 类型匹配问题：FormBuilderField声明泛型为非空int，但initialValue直接赋值可能为null的widget.id，编辑态下id未赋值时会触发空强转错误
2. 强制空检查隐患：代码中对可空参数widget.name、widget.logo直接使用!或做字符串拼接，编辑态参数未传入时会直接触发空值错误
3. 组件嵌套错误：FormBuilderField的builder内部嵌套了多余的Form组件，会打断父级FormBuilder的作用域传递，导致表单字段注册时找不到对应上下文，触发空引用

修复方案 #

调整代码如下即可解决：

• 显式声明FormBuilderField的泛型类型，给所有可空参数增加空值兜底逻辑，移除无意义的强制空检查运算符
• 删除builder内部多余的Form嵌套组件，保证字段处于父级FormBuilder的正常作用域下

修复后的核心代码参考：

@override
Widget build(BuildContext context) {
  return FormBuilderField<int>(
    name: 'ngoId',
    initialValue: widget.id ?? 0, // 空值设置业务默认值
    builder: (FormFieldState<int> field) {
      // 移除内部多余的Form嵌套
      return Card(
        child: Row(
          children: [
            const SizedBox(width: 10),
            Padding(
              padding: const EdgeInsets.all(10),
              child: CachedNetworkImage(
                imageUrl: widget.logo != null ? '${widget.logo}_SMALL.jpg' : '',
                placeholder: (context, url) => const CircularProgressIndicator(),
                errorWidget: (context, url, error) => const Icon(Icons.error),
                height: 80,
                fit: BoxFit.contain,
              ),
            ),
            Expanded(
              child: Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  Text(
                    widget.name ?? '未选择NGO', // 空值兜底文案
                    textAlign: TextAlign.center,
                    style: GoogleFonts.k2d(
                      textStyle: const TextStyle(
                        fontWeight: FontWeight.w600,
                        fontSize: 14,
                        color: Colors.black,
                      ),
                    ),
                  ),
                ],
              ),
            )
          ],
        ),
      );
    },
  );
}

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