$in操作符用于匹配字段值等于指定数组中任一值的文档；空数组会意外匹配全部文档，需校验长度；仅支持一维数组，类型严格匹配，大数据量需建索引，值过多时应分批处理。
用 $in 查询多个固定值，但数组不能是空的
直接用 $in 就行，但要注意：如果传入空数组（比如 []），MongoDB 会匹配所有文档——这和 SQL 的 IN () 报错或返回空结果完全不同，极易引发数据误读。
常见错误现象：db.users.find({ status: { $in: [] } }) 返回全部用户，而不是“没匹配到”。
- 使用前务必校验数组长度：
if (values.length === 0) return []; -
$in只支持一维数组，嵌套数组会被当作单个元素处理 - 类型必须严格匹配，
"1"和1是不同值，不会被同时命中
在 Node.js 驱动中传参时，避免意外的 ObjectId 转换
MongoDB Node.js 驱动（如 mongodb@6+）对字符串 ID 自动转 ObjectId 的行为只发生在字段名为 _id 时；其他字段（如 authorId）不会自动转换，必须手动处理。
典型场景：前端传来 ["65a1b2c3d4e5f67890123456", "65a1b2c3d4e5f67890123457"]，想查 authorId 字段：
- 如果直接塞进
$in，查询的是字符串，不是ObjectId，查不到数据 - 正确做法：用
new ObjectId()显式转换每个值，再传入$in - 转换前要加
ObjectId.isValid()校验，否则非法字符串会抛出异常
const { ObjectId } = require('mongodb');
const ids = req.query.ids.split(',').filter(Boolean);
const objectIds = ids
.filter(id => ObjectId.isValid(id))
.map(id => new ObjectId(id));
if (objectIds.length === 0) return [];
db.collection('posts').find({ authorId: { $in: objectIds } });
$in 性能不如等值查询，大数据量时注意索引覆盖
$in 本质是多个等值查询的合并，但 MongoDB 不会为每个值单独走索引查找，而是做一次索引范围扫描（Index Bounds），所以它依赖字段上有合适的索引。
- 单字段查询：确保目标字段有单字段索引，例如
{ status: 1 } - 复合查询：若用
{ status: { $in: [...] }, type: "article" }，建议建复合索引{ status: 1, type: 1 }，且把$in字段放前面 - 值数量过多（如超过 500 个）时，查询计划可能退化，考虑分批执行或改用聚合管道 +
$lookup关联
替代方案：用 $or 还是 $in？
表面上 { $or: [{ a: 1 }, { a: 2 }, { a: 3 }] } 和 { a: { $in: [1, 2, 3] } } 效果一样，但底层行为差异明显。
-
$in支持索引高效扫描，$or每个子条件需独立走索引（除非所有子条件都命中同一索引） -
$or允许不同字段组合（如{ $or: [{ a: 1 }, { b: 2 }] }），$in只能用于同一字段 - 聚合阶段里不能直接用
$in做条件过滤（得用$expr+$in），而$or在$match中天然可用
真正容易被忽略的是：当值来自用户输入且含 null 或缺失字段时，$in 默认不匹配 null，也不匹配该字段不存在的文档——这点和 SQL 的 IN 一致，但常被当成“漏数据”排查半天。
