使用PHP更新MongoDB子文档遇阻，寻求解决方案

首先拆解你的核心问题：

1. 子文档ID重复导致无法定位目标元素 #

你的示例Mongo文档中，people数组的两个子文档_id完全相同：

{
    "_id" : ObjectId("65cae601528e6e4b03a9201f"),
    "name" : "Person 1"
},
{
    "_id" : ObjectId("65cae601528e6e4b03a9201f"),
    "name" : "Person 2"
}

MongoDB的$占位符在数组中只会匹配第一个符合查询条件的元素，所以即使你想更新第二个子文档，也会因为ID重复而修改第一个。这是首要问题，先修正子文档的_id，保证每个子文档ID唯一。

2. 查询条件与更新操作的写法问题 #

你的原代码有两处可以优化的地方：

• 查询条件无需嵌套$elemMatch，直接通过people._id匹配更简洁；
• 如果要更新子文档的所有字段，不能只单独设置name，需要直接替换整个子文档（或按需设置多个字段）。

修正后的PHP代码示例 #

假设你使用的是官方mongodb/mongodb扩展（推荐），代码如下：

// 初始化MongoDB客户端、数据库和集合
$client = new MongoDB\Client("mongodb://localhost:27017");
$db = $client->selectDatabase('your_db_name');
$collection = $db->selectCollection('your_collection_name');

// 转换ID为ObjectId实例（必须，否则无法匹配Mongo中的ObjectId类型字段）
$parentId = new MongoDB\BSON\ObjectId($_id);
$personId = new MongoDB\BSON\ObjectId($person_id);

// 查询条件：匹配父文档ID，以及数组中指定ID的子文档
$filter = [
    "_id" => $parentId,
    "people._id" => $personId
];

// 更新操作：替换匹配到的子文档的所有字段
$update = [
    '$set' => [
        "people.$" => [
            "_id" => $personId,
            "name" => $name,
            // 这里添加其他需要更新的字段，比如：
            "age" => 28,
            "email" => "person2@example.com"
        ]
    ]
];

// 执行更新并检查结果
$result = $collection->updateOne($filter, $update);
if ($result->getModifiedCount() > 0) {
    echo "子文档更新成功";
} else {
    echo "未找到匹配的文档，或无需更新";
}

额外排查点 #

• 确认$_id和$person_id是有效的ObjectId字符串，且代码中正确转换为MongoDB\BSON\ObjectId（旧版mongo扩展用MongoId类）；
• 先用findOne($filter)查询，验证是否能找到目标文档，确认条件是否正确；
• 检查当前MongoDB用户是否有集合的更新权限；
• 如果使用旧版MongoDB（低于3.2），部分数组更新语法可能不支持，建议升级到稳定版本。

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