Firebase文档路径无效报错：获取子集合引用返回500错误

你遇到的问题核心是直接返回Firestore的集合引用对象导致NestJS序列化失败——虽然打印引用路径正常，但Firestore的CollectionReference是包含内部属性的复杂对象，NestJS默认的JSON序列化无法正确处理它，最终触发了看似路径为空的500错误（实际是序列化过程中抛出的异常被框架捕获后返回的错误信息）。

具体解决步骤 #

1. 不要直接返回引用对象 #

Firestore引用不是可直接序列化的JSON对象，你需要返回引用的路径字符串，或者直接查询子集合的数据返回：

示例1：返回子集合路径

@Get(':id/questions/path')
async getQuestionsCollectionPath(@Param('id') questionnaireId: string) {
  const questionsRef = this.firestore
    .collection('questionnaires')
    .doc(questionnaireId)
    .collection('questions');
  // 返回路径字符串而非引用对象
  return { collectionPath: questionsRef.path };
}

示例2：直接返回子集合的数据

如果你的需求是获取子集合的内容，直接在服务层完成查询后返回数据：

import { BadRequestException } from '@nestjs/common';

@Get(':id/questions')
async getQuestionnaireQuestions(@Param('id') questionnaireId: string) {
  // 先校验ID非空
  if (!questionnaireId) {
    throw new BadRequestException('问卷ID不能为空');
  }

  const questionsSnapshot = await this.firestore
    .collection('questionnaires')
    .doc(questionnaireId)
    .collection('questions')
    .get();

  // 将快照转换为可序列化的JSON对象
  return questionsSnapshot.docs.map(doc => ({
    id: doc.id,
    ...doc.data()
  }));
}

2. 排查参数传递问题 #

虽然你打印路径正常，但可以额外确认路由参数是否正确解析：在方法开头打印questionnaireId的值，确保NestJS正确获取到了URL中的ID参数，避免因路由定义错误（比如参数名拼写不一致）导致ID为空的情况。

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