要查询mongodb中的嵌套文档，1. 使用点符号（dot notation）来访问深层字段，例如：$filter = ['user.address.city' => '北京'];；2. 对于数组中的嵌套对象，使用 $elemmatch 操作符，例如：$filter = ['user.addresses' => ['$elemmatch' => ['city' => '上海']]];；3. 动态构建查询条件时，应合并多个条件到一个 $elemmatch 中以避免覆盖；4. 使用投影（projection）控制返回字段，如：'projection' => ['user.name' => 1, 'user.addresses.city' => 1]；注意字段路径正确性、引号使用、精确匹配机制及数组结构处理，确保查询准确有效。
要从MongoDB中查询嵌套文档，尤其是在PHP环境下，确实需要一些技巧。因为MongoDB的文档结构本身是层级化的，嵌套字段在查询时不能像普通字段那样直接用等于号匹配。你需要了解如何使用点符号（dot notation）来访问深层字段，并结合PHP的MongoDB驱动进行操作。
下面我会一步步说明怎么实现这个过程，包括基本语法、常见问题和实用建议。
查询嵌套文档的基本方法
在MongoDB中，如果你有一个类似如下的文档结构：
立即学习“PHP免费学习笔记（深入）”；
{
"user": {
"name": "张三",
"address": {
"city": "北京",
"zip": "100000"
}
}
}你想查找address.city为“北京”的记录，就可以使用点符号来指定路径：
$filter = ['user.address.city' => '北京']; $cursor = $collection->find($filter);
这样就能正确命中目标文档了。注意这里的键名是字符串形式，且必须严格按照字段的嵌套结构书写。
常见错误与注意事项
很多新手在查询嵌套字段时容易犯以下几个错误：
-
写错字段路径：比如把
user.address.city误写成user.city，自然查不到结果。 - 忘记引号或使用变量不当：确保你拼接的查询条件格式正确。
-
误以为可以模糊匹配：MongoDB默认是精确匹配，除非你用正则或者
$regex操作符。 - 没有考虑数组中的嵌套对象：如果嵌套字段是一个数组，那就要用不同的方式处理。
举个例子，如果你的结构是这样的：
{
"user": {
"name": "李四",
"addresses": [
{ "type": "home", "city": "上海" },
{ "type": "work", "city": "杭州" }
]
}
}想查出用户有地址在“上海”的记录，就不能再用上面的方法，而是要用 $elemMatch：
$filter = [
'user.addresses' => [
'$elemMatch' => ['city' => '上海']
]
];
$cursor = $collection->find($filter);在PHP中构建动态查询条件
有时候你会根据用户输入或其他条件动态生成查询语句。这个时候建议你使用关联数组来构造过滤器，而不是拼接字符串，避免格式错误。
例如，假设你要根据城市和地址类型查询用户：
$criteria = [];
if (!empty($_GET['city'])) {
$criteria['user.addresses'] = [
'$elemMatch' => ['city' => $_GET['city']]
];
}
if (!empty($_GET['type'])) {
$criteria['user.addresses'] = [
'$elemMatch' => ['type' => $_GET['type']]
];
}
// 合并多个条件时要注意，上面的写法会覆盖前面的
// 更好的做法是合并 elemMatch 中的条件不过上面这段代码有个小问题：两次赋值会覆盖掉前一个条件。更合理的写法是合并两个查询条件在一个 $elemMatch 中：
$criteria = [];
$elemMatch = [];
if (!empty($_GET['city'])) {
$elemMatch['city'] = $_GET['city'];
}
if (!empty($_GET['type'])) {
$elemMatch['type'] = $_GET['type'];
}
if (!empty($elemMatch)) {
$criteria['user.addresses']['$elemMatch'] = $elemMatch;
}这样就更灵活也安全了。
使用投影只获取需要的数据
有时候你不需要返回整个文档，只想拿到嵌套结构中的某一部分。这时候可以用投影（projection）来控制返回的字段。
例如，只想返回用户的名称和对应的城市：
$options = [
'projection' => [
'user.name' => 1,
'user.addresses.city' => 1
]
];
$cursor = $collection->find($filter, $options);但要注意的是，这种方式返回的仍然是完整文档结构，只是部分字段被包含或排除。如果你希望只提取特定子文档，可能需要用聚合管道 $project 来做进一步处理。
基本上就这些内容了。掌握好点符号、$elemMatch 和投影的使用，就能应对大部分嵌套文档的查询需求。虽然看起来不复杂，但在实际开发中稍有不慎就会出错，所以一定要多测试、多验证查询结果。
