Flutter中能否基于本地Firestore模拟器开展Firestore操作类单元测试？

完全可以用本地Firestore模拟器做单元测试，既能精准测你的数据操作逻辑，又能避开集成测试的UI依赖和慢速度问题。下面是具体实现步骤：

1. 改造数据操作类，支持依赖注入 #

你现在的ExampleClass把FirebaseFirestore.instance写死了，得改下构造函数，允许传入自定义的Firestore实例——这样测试时就能换成连接模拟器的实例：

class ExampleClass {
  final FirebaseFirestore _firestore;

  // 构造函数支持注入Firestore实例，默认用全局实例（生产环境用）
  ExampleClass({FirebaseFirestore? firestore}) 
      : _firestore = firestore ?? FirebaseFirestore.instance;

  Future<void> createObject(String id, Map<String, dynamic> data) async {
    await _firestore.collection('objects').doc(id).set(data);
  }

  Future<Map<String, dynamic>?> editObject(String id, Map<String, dynamic> updates) async {
    await _firestore.collection('objects').doc(id).update(updates);
    return (await _firestore.collection('objects').doc(id).get()).data();
  }

  Future<void> deleteObject(String id) async {
    await _firestore.collection('objects').doc(id).delete();
  }
}

2. 编写单元测试代码 #

用test包写单元测试，在测试里初始化Firebase并连接到本地模拟器：

先确保pubspec.yaml包含必要依赖：

dev_dependencies:
  test: any
  firebase_core: any
  cloud_firestore: any

然后写测试文件（比如example_class_test.dart）：

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:test/test.dart';
import 'package:your_project/example_class.dart';

void main() {
  late FirebaseFirestore firestore;
  late ExampleClass exampleClass;

  setUpAll(() async {
    // 初始化Firebase核心
    await Firebase.initializeApp();
    // 配置连接本地Firestore模拟器（默认端口8080）
    firestore = FirebaseFirestore.instance;
    firestore.useFirestoreEmulator('localhost', 8080);
  });

  setUp(() {
    // 每次测试前创建ExampleClass实例，传入模拟器的Firestore
    exampleClass = ExampleClass(firestore: firestore);
  });

  tearDown(() async {
    // 每次测试后清空测试集合，避免数据干扰后续测试
    final snapshot = await firestore.collection('objects').get();
    for (final doc in snapshot.docs) {
      await doc.reference.delete();
    }
  });

  test('创建对象后能正确读取', () async {
    const testId = 'test123';
    const testData = {'name': 'Test Object', 'value': 42};

    await exampleClass.createObject(testId, testData);
    final doc = await firestore.collection('objects').doc(testId).get();

    expect(doc.exists, isTrue);
    expect(doc.data(), equals(testData));
  });

  test('编辑对象后数据更新正确', () async {
    const testId = 'test456';
    final initialData = {'name': 'Old Name', 'value': 10};
    const updates = {'name': 'New Name', 'value': 20};

    // 先创建初始数据
    await firestore.collection('objects').doc(testId).set(initialData);
    // 调用编辑方法
    final updatedData = await exampleClass.editObject(testId, updates);

    expect(updatedData?['name'], equals(updates['name']));
    expect(updatedData?['value'], equals(updates['value']));
  });

  test('删除对象后文档不存在', () async {
    const testId = 'test789';
    // 先创建测试数据
    await firestore.collection('objects').doc(testId).set({'name': 'To Delete'});

    await exampleClass.deleteObject(testId);
    final doc = await firestore.collection('objects').doc(testId).get();

    expect(doc.exists, isFalse);
  });
}

3. 运行测试前的准备 #

• 启动本地Firestore模拟器：执行firebase emulators:start --only firestore命令
• 运行测试：执行flutter test命令，测试会直接连接模拟器，无需启动UI

这种方式完全跳过UI层，只针对数据操作逻辑测试，执行速度远快于集成测试，同时能保证逻辑正确性。

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