Apple Sign In改用户名触发Firestore路径空报错，求.document(uid)处理方案

这个错误的核心原因很明确：你调用updateUserName方法时传入的uid是空字符串，新版Firebase Firestore会严格校验文档路径，空字符串会直接触发FIRInvalidArgumentException。

具体处理方案： #

1. 在方法内部添加前置校验

直接在updateUserName里先检查uid是否为空，提前拦截错误，避免走到Firestore操作环节：

static func updateUserName(with newName: String, uid: String, completion: @escaping (Result<Bool, Error>) -> Void) {
    // 先校验uid非空
    guard !uid.isEmpty else {
        let emptyUidError = NSError(domain: "AppError", code: 1001, userInfo: [NSLocalizedDescriptionKey: "用户ID不能为空"])
        completion(.failure(emptyUidError))
        return
    }
    
    let reference = Firestore.firestore().collection(FBKeys.CollectionPath.users)
        .document(uid)
    reference.setData(["name": newName], merge: true) { err in
        if let err = err {
            completion(.failure(err))
            return
        }
        completion(.success(true))
    }
}

2. 排查uid的来源问题

• 检查Apple Sign In登录后的逻辑：确认是否正确获取并存储了用户的uid（比如存到UserDefaults或Keychain）
• 在调用updateUserName的地方打印uid值，确认是哪个环节导致uid变成了空字符串——比如登录状态失效、本地存储读取失败等

3. 封装通用安全访问方法（可选）

如果想避免其他Firestore操作也出现类似问题，可以封装一个工具方法统一处理文档ID校验：

extension Firestore {
    func safeDocument(in collection: String, withId docId: String) -> DocumentReference? {
        guard !docId.isEmpty else {
            print("[Firestore] 错误：文档ID为空字符串")
            return nil
        }
        return self.collection(collection).document(docId)
    }
}

使用时先判断是否拿到有效的DocumentReference，再执行数据操作。

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