MongoDB子文档更新语句转PHP后无法正常运行问题求助

排查步骤 #

• 校验字段与参数匹配度：原生更新语句使用questions.ident作为数组子文档匹配条件，但你提供的示例数据中questions数组子文档仅包含id字段，无ident字段。首先确认生产环境实际数据的questions子文档是否存在ident字段，同时校验传入的$room变量是否与目标文档_id的值、类型完全一致，$ident变量是否与目标子文档的匹配字段值一致。
• 捕获具体错误信息：在更新代码外层新增异常捕获逻辑，输出MongoDB驱动返回的具体错误：

try {
    $rooms_db->updateOne(
        ["_id" => $room, "questions.ident" => $ident],
        ['$set' => ["questions.$.released" => true, "questions.$.time" => $time]]
    );
} catch (\MongoDB\Driver\Exception\Exception $e) {
    var_dump($e->getMessage());
}

• 校验匹配条件是否可命中文档：执行更新前先查询符合条件的文档是否存在，排除无匹配文档导致更新无响应的问题：

$matchDoc = $rooms_db->findOne(["_id" => $room, "questions.ident" => $ident]);
var_dump($matchDoc); // 若返回为空则是匹配条件错误

• 验证MongoDB PHP驱动版本：确认使用的是官方推荐的mongodb扩展，而非已废弃的旧版mongo扩展，两类扩展的更新方法参数结构不兼容。

解决方案 #

• 字段不匹配修复：如果实际数据中questions子文档的唯一标识字段是id而非ident，将匹配条件改为questions.id即可：

$rooms_db->updateOne(
    ["_id" => $room, "questions.id" => $ident],
    ['$set' => ["questions.$.released" => true, "questions.$.time" => $time]]
);

• 旧驱动兼容修复：如果使用的是已废弃的mongo扩展，替换为对应版本的更新写法：

$rooms_db->update(
    ["_id" => $room, "questions.ident" => $ident],
    ['$set' => ["questions.$.released" => true, "questions.$.time" => $time]],
    ["multiple" => false]
);

• 高兼容性写法：如果需要兼容子文档不存在的场景，推荐使用arrayFilters语法，逻辑更清晰，适配性更强：

$rooms_db->updateOne(
    ["_id" => $room],
    ['$set' => [
        "questions.$[item].released" => true,
        "questions.$[item].time" => $time
    ]],
    [
        "arrayFilters" => [["item.ident" => $ident]]
    ]
);

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