Python中Cloud Firestore初始化后并发查询卡顿原因咨询

问题现象 #

使用Python的concurrent.futures并发查询Cloud Firestore时，若在Firebase应用初始化后直接发起并发请求，会出现查询停滞、无法及时返回响应的情况。添加一次同步的虚拟查询（如db.collection("a").document("b").get()）后，并发查询即可正常执行，而该虚拟查询本不应是必需步骤。

原因分析 #

这并非操作疏漏，而是Firebase Admin SDK的懒加载初始化特性导致的：

• Firebase Admin SDK的底层资源（如认证令牌、连接池、会话上下文）并非在initialize_app或firestore.client()调用时完全初始化，而是在第一次实际发起Firestore请求时才完成懒加载。
• 当多个线程同时触发这一懒加载过程时，可能会引发线程安全问题（比如资源竞争、内部锁阻塞），导致所有请求陷入停滞。
• 虚拟查询的作用是提前在主线程中完成所有懒加载初始化，后续并发线程可以直接复用已初始化的资源，避免了竞争冲突。

优化建议 #

1. 保留虚拟查询但优化操作：可以使用更轻量的同步操作触发初始化，比如调用db.collection("a").document("b").get()（即使文档不存在也没关系，关键是触发SDK内部初始化），这是最简单有效的方式。
2. 避免并发线程触发初始化：确保在启动线程池之前，主线程已经完成至少一次Firestore请求，确保SDK内部资源初始化完成。
3. 检查SDK版本：确认使用的是最新版的firebase-admin SDK，部分旧版本可能存在线程安全相关的bug，升级后可能无需虚拟查询即可正常工作。

验证代码调整 #

可以将虚拟查询替换为更明确的初始化触发操作，比如：

# 触发SDK内部初始化，替代原虚拟查询
try:
    db.collection("dummy").document("init").get()
except Exception:
    # 即使文档不存在或报错也没关系，只要触发了初始化流程
    pass

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