应用向Cloud Firestore存储FCM Token时崩溃,提示文档引用段数非法
崩溃根因
FIRESTORE INTERNAL ASSERTION FAILED: Invalid document reference. Document references must have an even number of segments, but users_table has 1
这个错误是Firebase客户端在本地做路径合法性校验时直接抛出的,请求根本没有发往服务端,和你当前数据库为空、还没有手动创建users_table集合完全无关。
Firebase的规则是,合法的文档引用必须是偶数个路径段:比如users_table/abc123是2段,属于合法文档引用;如果是3段users_table/abc123/子集合,也属于指向子集合里的文档的合法引用。你现在触发报错,本质是传给document()方法的userID是空字符串/空值,SDK拼接路径时自动忽略了末尾的空文档ID,最终拼出来的引用只剩users_table这1个节点,退化成了集合引用,不符合文档引用的要求,就触发了内部断言崩溃。
排查与修复步骤
- 先核对
userID的取值逻辑:绝大多数触发这个报错的场景,都是方法调用时机早于Firebase Auth的登录状态初始化,拿到的userID是未赋值的空值;也可能是自定义存储的全局userID没有做空值校验,存入了无效的空字符串。 - 给路径拼接逻辑加前置校验,从根源上避免把空值传给document方法,调整后的示例代码:
func updateFirestorePushTokenIfNeeded() { // 提前校验所有依赖值的有效性,不满足条件直接终止执行 guard let token = Messaging.messaging().fcmToken, let userID = Auth.auth().currentUser?.uid, !userID.isEmpty else { return } let usersRef = Firestore.firestore().collection("users_table").document(userID) usersRef.setData(["fcmToken": token], merge: true) }
- 注意调用时机:FCM Token本身会在应用重启、清除缓存、更换设备后自动更新,建议这个方法的触发点选在两个场景:一是Firebase Auth完成登录状态同步的回调、二是FCM SDK触发token更新的代理回调里,不要在App启动的最早期(Auth状态还没加载完成)直接调用这个方法。
内容的提问来源于stack exchange,提问作者Faraz A. Khan
相关产品推荐
相关产品推荐

