MongoDB 4.2 完全弃用 insert 命令，因其底层移除 OP_INSERT 操作码支持，仅响应 insertOne/insertMany 对应的 OP_MSG 协议格式，客户端调用 insert 会直接报错或静默失败，必须显式改用 insertOne 或 insertMany 并适配其错误处理、返回结构及选项行为。
MongoDB 3.2 的 insert 命令在 4.2 中已**完全弃用且不可用**，不是“还能用但不推荐”，而是客户端驱动（如 Node.js、Python PyMongo、Java Driver）在连接 4.2+ 服务端时会直接报错或静默降级失败。必须改用 insertOne 或 insertMany。
为什么 4.2 不再接受 insert() 调用
MongoDB 4.0 起正式移除对旧 wire protocol 中 insert OP_INSERT 操作码的支持，4.2 完全只响应 insertOne/insertMany 对应的 OP_MSG 协议格式。这不是语法糖变化，是底层通信协议升级。
- 3.2 客户端发
insert→ 服务端接收 OP_INSERT → 成功 - 4.2 客户端发
insert（如老版 PyMongo 3.7 未指定兼容模式）→ 服务端返回CommandNotFound错误或空响应 - 4.2 要求所有插入必须带明确的单/多文档语义，以配合事务、写关注（
writeConcern）和错误粒度控制
insertOne 和 insertMany 的行为差异
insertOne 和 insertMany 不只是命名变化，它们在错误处理、返回结构和默认行为上完全不同：
-
insertOne：插入单个文档，成功返回含_id的对象（如{ acknowledged: true, insertedId: ObjectId("...") }）；失败抛出异常，不返回部分结果 -
insertMany：默认开启ordered: true，遇到第一个错误即停止，只插入前面成功的文档；设{ ordered: false }可继续执行，但返回结果中insertedIds是按原始顺序的稀疏映射（失败位置为undefined） - 两者都支持
writeConcern和bypassDocumentValidation选项，而旧insert不支持细粒度写关注配置
Spring Data MongoDB 中 mongoTemplate 的适配要点
如果你用的是 mongoTemplate，注意它在不同驱动版本下的实际委托行为：
- Spring Data MongoDB 2.x（对应 MongoDB Java Driver 3.11）仍保留
insert方法，但底层已转译为insertOne/insertMany，**仅当连接 4.2+ 时才安全** - Spring Data MongoDB 3.0+（Driver 4.0+）彻底删除了
mongoTemplate.insert()的重载方法，只留insertOne()和insertMany() - 常见坑：
mongoTemplate.insert(new ArrayList(), "coll")在旧版能运行，在 4.2+ 会报IllegalArgumentException: List cannot be null or empty—— 必须显式调用insertMany
升级时最容易被忽略的隐性依赖
很多项目没直接写 db.collection.insert(...)，但仍会因以下原因在 4.2 上失败：
- 第三方库（如 Mongoose 5.x 默认仍用
insert，需升级到 6.0+ 并启用useUnifiedTopology: true） - Shell 脚本里硬编码的
mongo --eval "db.coll.insert({})"—— MongoDB Shell 4.2+ 已将insert()改为别名，但远程连接 Cosmos DB for MongoDB 或云厂商 4.2 实例时，该别名不生效 - 备份恢复工具（如
mongorestore）若版本低于 4.2，可能用旧协议写入，导致 4.2 实例启动时报Invalid BSON
真正卡点往往不在主代码，而在 CI 脚本、运维工具链和依赖库的协议协商细节里。别只测 save()，要抓包看 wire protocol 实际发出的操作码。
