Firestore好友系统中使用DELETE_FIELD删除映射键值对失败问题

问题场景 #

基于Firestore开发好友管理系统时，用户接受好友请求的流程中：

• 成功将双方添加至对方的allFriends映射
• 但无法删除发起方ownRequests中的接收方条目，以及接收方friendRequests中的发起方条目
• 使用firestore.DELETE_FIELD执行删除操作未生效

可能原因及修复方案 #

1. 合并同一文档的多笔更新操作 #

原代码中对同一个文档多次调用transaction.update，虽然Firestore会尝试合并操作，但可能导致删除指令被意外覆盖或未正确执行。建议将同一文档的所有更新合并到单次update调用中，减少事务内的操作次数，提升稳定性。

2. 检查集合名称大小写匹配 #

Firestore集合名称区分大小写，确认代码中使用的集合名（Requests）与实际数据结构中的集合名（requests）完全一致，否则会操作到错误的文档，导致删除无效。

3. 确认DELETE_FIELD的正确引用 #

确保在代码中正确导入DELETE_FIELD：

from google.cloud.firestore import DELETE_FIELD

修正后的事务代码 #

@firestore.transactional
def accept_friend_request_transaction(transaction: Transaction, requester_ref, recipient_ref, friend_req: FriendRequest):
    requester_doc = requester_ref.get(transaction=transaction)
    recipient_doc = recipient_ref.get(transaction=transaction)

    if requester_doc.exists and recipient_doc.exists:
        # 合并发起方文档的所有更新：添加好友 + 删除发起的请求
        transaction.update(requester_ref, {
            f'allFriends.{friend_req.recipient}': 'true',
            f'ownRequests.{friend_req.recipient}': DELETE_FIELD
        })
        
        # 合并接收方文档的所有更新：添加好友 + 删除收到的请求
        transaction.update(recipient_ref, {
            f'allFriends.{friend_req.requester}': 'true',
            f'friendRequests.{friend_req.requester}': DELETE_FIELD
        })

验证步骤 #

1. 确保集合名称大小写完全匹配
2. 确认DELETE_FIELD已正确导入
3. 执行接受请求操作后，检查：
   • 双方allFriends中已添加对方UID
   • 发起方ownRequests中已移除接收方条目
   • 接收方friendRequests中已移除发起方条目

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