如何在纯Dart环境（非Flutter）本地访问Firestore进行测试？

核心疑问解答 #

1. 是否可通过纯Dart连接本地Firestore模拟器？
   可以，Firebase官方提供的纯Dart SDK完全支持连接本地Firestore模拟器，无需依赖Flutter框架，能直接在命令行环境下运行纯Dart测试。

2. 需要哪些配置或设置？

• 安装并配置Firebase CLI，用于启动本地模拟器
• 启动模拟器时指定端口（默认8080）
• 在Dart测试代码中配置Firestore客户端指向模拟器地址
• 使用任意测试用Firebase项目ID（无需关联真实项目）

3. 推荐的特定包或方法？

• cloud_firestore：官方Firestore Dart SDK，原生支持模拟器连接
• firebase_core：用于初始化Firebase核心服务
• test：Dart官方测试框架，编写单元测试的基础
• Firebase CLI：用于启动本地Firestore模拟器

步骤1：搭建本地Firestore模拟器 #

1. 安装Firebase CLI：执行 npm install -g firebase-tools（需先安装Node.js）
2. 初始化Firebase项目（已有项目可跳过）：在项目根目录执行 firebase init，选择Firestore完成初始化
3. 启动Firestore模拟器：执行 firebase emulators:start --only firestore，默认端口为8080，可通过firebase.json自定义端口

步骤2：从Dart测试连接本地模拟器 #

在测试文件中完成Firebase初始化与模拟器配置：

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

void main() {
  setUpAll(() async {
    // 初始化Firebase核心服务
    await Firebase.initializeApp(
      options: const FirebaseOptions(
        projectId: 'test-project-123', // 任意测试用ID，无需真实存在
        apiKey: 'dummy-key', // 模拟器不需要真实API Key
        appId: 'dummy-app-id',
      ),
    );

    // 配置Firestore指向本地模拟器
    FirebaseFirestore.instance.useFirestoreEmulator('localhost', 8080);
  });
}

步骤3：执行CRUD操作测试 #

编写测试用例验证增删改查逻辑：

void main() {
  // ... 上述初始化代码 ...

  group('Firestore CRUD Tests', () {
    late CollectionReference testCollection;

    setUp(() {
      testCollection = FirebaseFirestore.instance.collection('test-items');
    });

    test('Create and read document', () async {
      // 创建文档
      await testCollection.doc('item-1').set({'name': 'Apple', 'price': 5});
      
      // 读取并验证
      final doc = await testCollection.doc('item-1').get();
      expect(doc.exists, isTrue);
      expect(doc.data()?['price'], 5);
    });

    test('Update document', () async {
      await testCollection.doc('item-1').update({'price': 6});
      final doc = await testCollection.doc('item-1').get();
      expect(doc.data()?['price'], 6);
    });

    test('Delete document', () async {
      await testCollection.doc('item-1').delete();
      final doc = await testCollection.doc('item-1').get();
      expect(doc.exists, isFalse);
    });
  });
}

步骤4：测试间重置数据库状态 #

每次测试前调用模拟器的REST API清空数据，确保测试独立性：

import 'dart:io';

Future<void> resetFirestore() async {
  final client = HttpClient();
  final request = await client.postUrl(
    Uri.parse('http://localhost:8080/emulator/v1/projects/test-project-123/databases/(default)/documents'),
  );
  request.headers.set('Content-Type', 'application/json');
  await request.close();
}

// 在测试中使用
setUp(() async {
  await resetFirestore();
  testCollection = FirebaseFirestore.instance.collection('test-items');
});

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