直接用 insertone() 或 insertmany() 就能插入含数组和嵌套对象的文档，只要结构合法且符合 bson 规范——字段名不含 . 或 $、值不为 undefined/function/regexp、嵌套无循环引用、数组元素为纯数据，mongodb 原生支持。
直接用 insertOne() 或 insertMany() 就能插入含数组和嵌套对象的文档，不需要额外包装或转义 —— 只要结构是合法 BSON，MongoDB 原生支持。
插入时字段名和值必须符合 BSON 规范
MongoDB 不接受 JavaScript 中的 undefined、function、RegExp 等类型。嵌套对象和数组必须是纯数据结构：
- 嵌套对象不能有循环引用（如
a: { b: a }） - 数组元素可以是字符串、数字、对象、其他数组，但不能混入函数或日期对象字面量（要用
new Date()或 ISO 字符串） - 键名不能含
.或$（否则点号路径解析会出错，例如{"user.name": "Alice"}会被当成嵌套字段user.name）
正确示例：
db.users.insertOne({
name: "Alice",
tags: ["admin", "active"],
profile: {
age: 28,
address: { city: "Beijing", zip: "100000" }
},
contacts: [
{ type: "email", value: "a@example.com" },
{ type: "phone", value: "+8613800138000" }
]
})
批量插入多条含嵌套结构的文档要传数组
insertMany() 接收的是文档数组，不是单个文档 —— 容易漏掉中括号导致报错 TypeError: docs.forEach is not a function：
- ✅ 正确：
db.users.insertMany([{...}, {...}]) - ❌ 错误：
db.users.insertMany({...}, {...})（语法错误） - ❌ 错误：
db.users.insertMany({...})（传了对象，不是数组）
注意：如果某条文档因字段校验失败（如唯一索引冲突），默认按有序模式（ordered: true）会中断后续插入；需要跳过错误继续插，显式加参数：{ ordered: false }。
避免 _id 字段类型不一致引发重复或覆盖
手动指定 _id 时，类型必须与已有文档一致。常见陷阱：
- 用字符串
"123"当_id，后续又用ObjectId("123")查询 → 查不到（BSON 类型不同） - 插入时没设
_id，MongoDB 自动生成ObjectId；但之后用字符串 ID 更新，实际更新的是新文档（因为类型不匹配，find找不到旧记录） - 嵌套结构里也别用
_id字段（除非你真需要子文档 ID），否则容易和顶层_id混淆，尤其在聚合或索引时
数组字段为空或缺失时，$push / $set 行为差异明显
插入时留空数组（items: []）和完全不写该字段（{}），后续用更新操作符处理结果不同：
-
$push: { items: "new" }要求items是数组，若字段不存在会报错；若为null或字符串也会失败 -
$set: { "items.0.name": "x" }要求items存在且是数组，否则定位符$失效 - 稳妥做法：插入时明确初始化数组字段，如
items: []，而非依赖后续补全
真正麻烦的不是插入，而是后续更新时对这些嵌套数组做条件操作 —— 那才需要聚合管道、$[]、$[elem] 这些机制。插入本身，只要结构干净，几乎不会出问题。
