Swift中Firebase Firestore更新用户文档提示No document to update如何解决

错误核心原因 #

Firestore的updateData()方法仅支持对已存在的文档做字段更新，如果目标路径下没有对应的有效文档，就会抛出你遇到的Code=5 No document to update错误。你确认UID匹配但还是报错，常见原因如下：

• 集合名拼写不一致：代码中的utenti集合名和控制台实际集合名存在大小写差异、多余空格、拼写错漏等问题
• 文档ID带不可见字符：userID变量看起来和控制台ID一致，但实际前后带了换行、空格等不可见空白字符
• 斜体虚拟文档：控制台看到的目标文档是斜体显示，这种是该路径下存在子集合、但文档本身从未被创建过的虚拟占位，实际不存在有效文档
• 项目不匹配：App内置的GoogleService-Info.plist对应其他Firebase项目，和你当前查看数据库的控制台项目不一致
• 安全规则限制：Firestore安全规则拦截了当前用户的写入权限，出于安全策略会返回「文档不存在」的错误，避免暴露文档存在性

排查修复步骤 #

1. 校验路径准确性
   在更新逻辑前加入调试代码，打印完整路径和ID属性，逐字符和控制台对比：

// 插入到updateData调用前
let docRef = db.collection("utenti").document(userID)
print("目标文档完整路径：\(docRef.path)")
// 打印带包裹符的ID和长度，排查隐藏空白字符
print("userID内容：<\(userID)>, 字符长度：\(userID.count)")

2. 兼容文档不存在的场景
   如果你的业务需求是无论文档是否存在都要写入name字段，把updateData替换为setData:merge:即可，该方法会在文档不存在时自动创建，存在时仅更新指定字段：

@IBAction func bottoneModifica(_ sender: UIButton) {
    // 增加非空判断，避免强制解包崩溃
    guard let nuovoNome = textFieldNome.text, !nuovoNome.isEmpty else { return }
    print(nuovoNome)
    db.collection("utenti").document(userID).setData([
        "name": nuovoNome
    ], merge: true) { errore in
        if let errore = errore {
            print("Error updating document: \(errore)")
        } else {
            print("Document successfully updated")
        }
    }
}

3. 校验项目和权限配置

• 确认App使用的GoogleService-Info.plist是从当前查看的Firebase项目下载，Bundle ID和项目配置一致
• 临时修改Firestore安全规则为测试规则，验证是否是权限拦截导致的问题：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

测试通过后请及时修改为符合业务安全要求的规则，避免数据泄露

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