使用Flask和Python向Firebase集合添加记录失败无报错如何解决？

常见原因排查 #

• 项目匹配问题：核对serviceAccountKey.json中的project_id字段，确认与你查看的Firebase控制台项目ID完全一致。绝大多数此类问题都是因为写入操作实际执行到了其他项目中，导致当前项目看不到数据。
• 数据库实例不匹配：Firestore目前支持多实例部署，如果你使用的不是默认的(default)数据库，初始化客户端时需要显式指定数据库ID：

  db = firestore.client(database_id="你的自定义数据库ID")
  

• 服务账号权限不足：确认服务账号拥有Cloud Datastore User角色，具备文档写入权限。

代码优化调试方案 #

将原有代码替换为以下版本，增加调试日志同时规范返回值：

from flask import Flask
import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

cred = credentials.Certificate("serviceAccountKey.json")
firebase_admin.initialize_app(cred)

# 非默认数据库请取消注释并替换为实际数据库ID
# db = firestore.client(database_id="your_custom_db_id")
db = firestore.client()
app = Flask(__name__)

@app.route('/offers', methods=['PUT'])
def put_offer():
    try:
        # add方法返回 (写入时间, 文档引用对象) 元组
        update_time, doc_ref = db.collection('offers').add({'offer_email': 'foo@foo.com'})
        print(f"写入成功 | 文档ID: {doc_ref.id} | 写入时间: {update_time}")
        return "success", 200
    except Exception as e:
        print(f"写入错误: {str(e)}")
        return f"An Error Occurred: {str(e)}", 500

if __name__ == '__main__':
    app.run(debug=True, host='0.0.0.0')

验证逻辑 #

如果执行请求后控制台能正常打印文档ID，说明写入操作已经成功执行，优先核对项目、数据库ID是否匹配；如果控制台没有任何打印输出，说明请求没有命中当前路由，核对请求地址、请求方法是否与路由配置完全一致。

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