Flutter测试中setUpAll()未执行引发LateInitializationError问题求助

问题现象 #

按照教程实现setUpAll()方法后，运行flutter test时报错，原本未使用setUpAll()的代码可正常通过测试。报错信息如下：

test task provider test addTask [E]
LateInitializationError: Local '_taskProvider' has not been initialized.
dart:_internal LateError._throwLocalNotInitialized
test/task_provider_test.dart 22:7 main..

相关代码 #

无setUpAll()的测试代码（可正常运行） #

import 'package:flutter_test/flutter_test.dart';
import 'package:to_do_app_new/providers/task_provider.dart';

void main() {
  group("test task provider", () {
    test('test addTask', () {
      TaskProvider _taskProvider = TaskProvider();
      Task _task = Task(title: "MY TO DO ITEM #1", description: "GET GOOD");

      _taskProvider.addTask(_task);

      expect(_task.title, _taskProvider.items[0].title);
      expect(_task.description, _taskProvider.items[0].description);
    });
  });
}

含setUpAll()的测试代码（报错版本） #

import 'package:flutter_test/flutter_test.dart';
import 'package:to_do_app_new/providers/task_provider.dart';

late TaskProvider _taskProvider;
late Task _task;
void main() {
  group("test task provider", () {
    setUpAll() {
      _taskProvider = TaskProvider();
      _task = Task(title: "MY TO DO ITEM #1", description: "GET GOOD");
    }

    test('test addTask', () {
      _taskProvider.addTask(_task);

      expect(_task.title, _taskProvider.items[0].title);
      expect(_task.description, _taskProvider.items[0].description);
    });
  });
}

TaskProvider源码（task_provider.dart） #

import 'dart:collection';
import 'package:flutter/material.dart';
import 'package:uuid/uuid.dart';

class Task {
  bool completed;
  String title;
  String description;
  final String uuid;

  Task({this.completed = false, required this.title, required this.description})
      : uuid = const Uuid().v4();

  @override
  bool operator ==(covariant Task other) => uuid == other.uuid;
  @override
  int get hashCode => uuid.hashCode;

  setTitle(String title) {
    this.title = title;
  }
}

class TaskProvider extends ChangeNotifier {
  final List<Task> _items = [];

  findTask(Task task) {
    _items.firstWhere((i) => i.uuid == task.uuid);
  }

  UnmodifiableListView<Task> get items => UnmodifiableListView(_items);

  void addTask(Task task) {
    _items.add(task);
    notifyListeners();
  }
}

解决方案 #

问题出在**setUpAll的语法错误**：你当前的写法是在group内部定义了一个名为setUpAll的普通局部函数，测试框架并不会自动执行这个函数，导致_taskProvider和_task始终未初始化，触发LateInitializationError。

正确的写法是将初始化逻辑作为匿名函数参数传给测试框架提供的setUpAll方法：

import 'package:flutter_test/flutter_test.dart';
import 'package:to_do_app_new/providers/task_provider.dart';

late TaskProvider _taskProvider;
late Task _task;
void main() {
  group("test task provider", () {
    // 正确写法：将初始化逻辑传入setUpAll方法
    setUpAll(() {
      _taskProvider = TaskProvider();
      _task = Task(title: "MY TO DO ITEM #1", description: "GET GOOD");
    });

    test('test addTask', () {
      _taskProvider.addTask(_task);

      expect(_task.title, _taskProvider.items[0].title);
      expect(_task.description, _taskProvider.items[0].description);
    });
  });
}

额外提示 #

如果你的测试需要隔离状态（比如每个测试用例都需要全新的TaskProvider实例），建议使用setUp替代setUpAll：setUp会在每个测试用例执行前都运行一次初始化逻辑，避免测试用例之间的状态污染。

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