Flutter/Firebase中获取待审核书评的当前文档ID问题

问题背景 #

我维护一个书籍书评系统，用户提交的书评需经管理员审核后公开。初始实现中，创建书评使用Firestore自动生成ID，但管理员进入单个书评审核页面时，无法获取对应文档ID来执行验证、修改或删除操作。

初始创建书评代码 #

Future<void> addChapterReview() {
  return chapter_reviews
      .add({
        'anime_adaptation': animeAdaptation,
        'edited_in_france': editedInFrance,
        'link': chapterLinkController.text,
        'manga': chapterOriginalMangaController.text,
        'note': chapterNoteController.text,
        'number': chapterNumberController.text,
        'opinion': chapterOpinionController.text,
        'pic': chapterPicController.text,
        'title': chapterTitleController.text,
        'edited_in_france': isCheckedEdited,
        'anime_adaptation': isCheckedAnime,
        'isVerified': false,
      })
      .then((value) => print('书评添加成功。'))
      .catchError((error) => print('书评添加失败。'));
}

初始审核更新代码（存在ID获取问题） #

Future<void> sendValidation() async {
  await FirebaseFirestore.instance
      .collection("chapters")
      .doc("currentDocIdIWant")
      .update({'isVerified': 'true'});
}

你的尝试方案 #

尝试多种方法后仍无法获取目标ID，你改为将书评标题设为文档ID（替代Firestore自动生成ID），通过标题构建查询来执行审核操作，修改后的代码如下：

修改后的创建书评代码 #

Future<void> addChapterReview() {
  return chapter_reviews
      .doc(chapterTitleController.text)
      .set({
        'anime_adaptation': animeAdaptation,
        'edited_in_france': editedInFrance,
        'link': chapterLinkController.text,
        'manga': chapterOriginalMangaController.text,
        'note': chapterNoteController.text,
        'number': chapterNumberController.text,
        'opinion': chapterOpinionController.text,
        'pic': chapterPicController.text,
        'title': chapterTitleController.text,
        'edited_in_france': isCheckedEdited,
        'anime_adaptation': isCheckedAnime,
        'isVerified': 'false',
      })
      .then((value) => print('书评添加成功。'))
      .catchError((error) => print('书评添加失败。'));
}

修改后的审核更新代码 #

Future<void> sendValidation() async {
  await FirebaseFirestore.instance
      .collection("chapters")
      .doc(widget.chapterdata['title'])
      .update({'isVerified': 'true'});
}

更优解决方案 #

方案1：保留自动生成ID，传递ID到审核页面 #

这是Firestore的标准使用方式，能避免标题重复导致的文档覆盖问题：

1. 创建书评时记录自动生成ID
   调用add()后返回的DocumentReference包含生成的ID，可直接获取并传递到后续流程：

Future<void> addChapterReview() {
  return chapter_reviews
      .add({
        // 移除重复字段，保持字段唯一性
        'anime_adaptation': isCheckedAnime,
        'edited_in_france': isCheckedEdited,
        'link': chapterLinkController.text,
        'manga': chapterOriginalMangaController.text,
        'note': chapterNoteController.text,
        'number': chapterNumberController.text,
        'opinion': chapterOpinionController.text,
        'pic': chapterPicController.text,
        'title': chapterTitleController.text,
        'isVerified': false,
      })
      .then((docRef) {
        print('书评添加成功，文档ID：${docRef.id}');
        // 可将docRef.id存储到管理员审核列表数据源，或直接用于跳转
      })
      .catchError((error) => print('书评添加失败：$error'));
}

2. 审核列表传递ID到详情页
   管理员浏览待审核列表时，将每个书评的文档ID作为参数传递到审核详情页：

// 列表项点击事件示例
void navigateToReviewDetail(String docId) {
  Navigator.push(
    context,
    MaterialPageRoute(
      builder: (context) => ReviewDetailPage(docId: docId),
    ),
  );
}

3. 审核详情页用ID操作文档
   在详情页接收ID，直接用于更新/删除操作：

class ReviewDetailPage extends StatelessWidget {
  final String docId;
  const ReviewDetailPage({super.key, required this.docId});

  Future<void> sendValidation() async {
    await FirebaseFirestore.instance
        .collection("chapter_reviews") // 注意集合名与创建时保持一致
        .doc(docId)
        .update({'isVerified': true}); // 保持布尔值类型与创建时一致
  }

  @override
  Widget build(BuildContext context) {
    // 页面布局实现
    return Scaffold();
  }
}

方案2：优化标题作为ID的方案（若坚持使用） #

如果继续用标题作为ID，必须处理标题重复问题，避免新书评覆盖旧数据：

Future<void> addChapterReview() {
  // 为标题添加时间戳后缀，确保ID唯一性
  final docId = '${chapterTitleController.text}_${DateTime.now().millisecondsSinceEpoch}';
  return chapter_reviews
      .doc(docId)
      .set({
        'title': chapterTitleController.text,
        'anime_adaptation': isCheckedAnime,
        'edited_in_france': isCheckedEdited,
        'link': chapterLinkController.text,
        'manga': chapterOriginalMangaController.text,
        'note': chapterNoteController.text,
        'number': chapterNumberController.text,
        'opinion': chapterOpinionController.text,
        'pic': chapterPicController.text,
        'isVerified': false,
      })
      .then((value) => print('书评添加成功'))
      .catchError((error) => print('书评添加失败'));
}

同时审核列表需存储完整的带后缀文档ID，而非仅用标题查询，避免匹配多个文档。

关键注意事项 #

• 集合名统一：创建书评用的是chapter_reviews集合，更新时不要误写为chapters，否则会找不到目标文档。
• 字段类型统一：创建时isVerified是布尔值false，更新时不要改成字符串'true'，类型不一致会导致操作失败。
• 避免重复ID：自动生成ID是最安全的方式，自定义ID（如标题）必须确保全局唯一，否则会直接覆盖已有数据。

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