FastAPI调用Firestore报ValueError错误：求助定位问题根源

错误根源 #

你遇到的错误本质是FastAPI无法序列化异常对象，主要由两个问题引发：

1. 路由逻辑不匹配：路由定义了review_id参数，但函数完全未使用该参数，FastAPI处理请求时可能触发参数解析相关的隐性异常；
2. Firestore客户端初始化不完整：直接调用firestore.client()前未完成Firebase Admin SDK的初始化，导致客户端实例异常，进而在流式读取文档时抛出无法被序列化的错误。

修复步骤 #

1. 修正路由与业务逻辑 #

如果接口是读取所有评论，修改路由路径并移除无用参数：

@router.get("/reviews")
def read_all_reviews():
    db = firestore.client()
    reviews_ref = db.collection('Reviews')
    docs = reviews_ref.stream()

    output = {}
    for doc in docs:
        output[doc.id] = doc.to_dict()
    
    return output

如果是读取单个评论，保留路由参数并调整逻辑：

@router.get("/reviews/{review_id}")
def read_review(review_id: str):
    db = firestore.client()
    review_ref = db.collection('Reviews').document(review_id)
    doc = review_ref.get()
    if doc.exists:
        return doc.to_dict()
    else:
        return {"error": "Review not found"}

2. 完成Firebase Admin SDK初始化 #

在项目启动入口（如main.py）添加初始化代码，确保仅执行一次：

import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

# 替换为你的服务账号密钥文件路径
if not firebase_admin._apps:
    cred = credentials.Certificate("./serviceAccountKey.json")
    firebase_admin.initialize_app(cred)

3. 处理特殊数据类型 #

如果Firestore文档包含Timestamp等非JSON原生类型，需手动转换后返回：

from datetime import datetime

# 示例：将Timestamp转为ISO格式字符串
output[doc.id] = {
    k: v.isoformat() if isinstance(v, datetime) else v 
    for k, v in doc.to_dict().items()
}

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