Laravel中基于participantId数组匹配删除Firestore聊天文档问题排查

核心问题：字段名不匹配 #

从你提供的Firestore集合截图来看，聊天文档的数组字段是**participantIds**（复数形式），但你的代码中查询条件用的是participantId（单数），这直接导致查询无法匹配到目标文档，删除操作自然不会生效。

修正后的代码 #

将查询条件中的字段名改为participantIds即可：

$collectionRef = $db->collection('chats');
// 修正字段名为 participantIds
$query = $collectionRef->where('participantIds', 'array-contains', $userId);

$querySnapshot = $query->documents();

foreach ($querySnapshot as $document) {
    Log::info("QuerySnapshot data: " . print_r($document->data(), true));
    $document->reference()->delete();
    Log::info("Chat document deleted: " . $document->id());
}

$docRef = $db->collection('users')->document($userId);
$docRef->delete();

额外排查点 #

• 确认$userId的类型与Firestore数组中存储的元素类型完全一致（比如都是字符串，注意大小写、是否有多余空格）
• 检查Firestore的安全规则是否允许当前API服务账号执行查询和删除操作
• 查看日志输出，如果修正后仍无文档被删除，说明$userId可能未出现在任何participantIds数组中，需要验证$userId的正确性

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