Flutter + Firestore：如何插入含DocumentReference的新文档？

你的问题核心是同步代码中的空安全问题未被捕获，导致应用直接崩溃，而非Firestore存储DocumentReference本身的问题。以下是具体排查和修复步骤：

1. 捕获所有错误（包括同步错误） #

当前的try-catch仅包裹了异步的addDocument调用，但_buildProductData()是同步方法，其中的强制解包（!）或数组越界错误会直接触发崩溃，不会进入异步异常捕获流程。

修改添加产品的方法，将同步对象创建也纳入try块：

Future<void> addProduct() async {
  try {
    // 将产品对象创建移到try内，捕获同步错误
    final product = _buildProductData();
    await _firestoreService.addDocument(
      collectionPath: collection,
      data: product.toMap(),
      documentId: product.name,
    );
  } catch (e) {
    // 打印具体错误信息，方便排查
    print('添加产品失败详情: $e');
    throw Exception('Nie udało się dodać produktu');
  }
}

2. 修复空安全隐患 #

_buildProductData()中大量使用强制解包（!），如果_selectedBrand为空、_activeCategory为空列表，或者doc.reference为空，都会直接崩溃。添加前置检查：

Products _buildProductData() {
  // 前置空检查，避免强制解包崩溃
  if (_selectedBrand == null) {
    throw Exception('请选择品牌');
  }
  if (_activeCategory.isEmpty) {
    throw Exception('请选择分类');
  }

  final categoryItem = _activeCategory.toList()[0];
  if (categoryItem.doc.reference == null) {
    throw Exception('分类引用无效');
  }

  return Products(
    id: '', 
    name: _nameController.text, 
    ean: _eanController.text,
    brand: _selectedBrand!.reference!,
    category: categoryItem.doc.reference!,
  );
}

3. 优化Products类的类型转换 #

fromFirestore方法中直接将data['brand']赋值给DocumentReference，缺乏显式类型转换，可能导致类型不匹配问题：

factory Products.fromFirestore(DocumentSnapshot doc) {
  final data = doc.data() as Map<String, dynamic>;
  return Products(
    id: doc.id,
    name: data['name'] ?? '',
    ean: data['ean'] ?? '',
    // 显式转换类型，确保类型安全
    brand: data['brand'] as DocumentReference,
    category: data['category'] as DocumentReference,
  );
}

额外排查点 #

• 确认Firestore SDK为最新版本，旧版本可能存在DocumentReference序列化的兼容性问题。
• 检查_firestoreService.addDocument方法内部是否正确处理了DocumentReference类型的字段（Firestore原生SDK支持直接存储DocumentReference，无需额外转换）。

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