Spring Data MongoDB 本身不提供类似 JPA 的 JDBC 批处理配置项，其批量插入能力天然依托于 MongoDB 原生的 insertMany 操作，通过单次网络请求完成多文档写入，性能高效且无需额外配置。
spring data mongodb 本身不提供类似 jpa 的 jdbc 批处理配置项，其批量插入能力天然依托于 mongodb 原生的 `insertmany` 操作，通过单次网络请求完成多文档写入，性能高效且无需额外配置。
在 Spring Boot 应用中集成 MongoDB 时，开发者常误以为需像 Spring Data JPA 那样通过 spring.jpa.properties.hibernate.jdbc.batch_size 等属性启用批处理。但需明确：MongoDB 与关系型数据库的持久化机制本质不同——它原生支持原子性批量写入，而 Spring Data MongoDB 的设计正是围绕这一特性构建的，而非模拟 JDBC 批处理语义。
✅ 正确的批量插入方式：使用 insertMany
Spring Data MongoDB 的 MongoTemplate 提供了 insertMany(...) 方法，这是实现高效批量插入的标准且推荐方式：
List<User> users = Arrays.asList(
new User("alice", 28),
new User("bob", 32),
new User("carol", 25)
);
// 单次调用 → 触发底层 driver 的 insertMany()
List<InsertOneResult> results = mongoTemplate.insertMany(users, "users");该方法内部会：
- 将每个实体对象转换为 BSON 文档（通过 MongoConverter）；
- 聚合为 List
； - 委托给 MongoDB Java Driver 的 MongoCollection.insertMany()；
- 最终通过单次网络请求将全部文档发送至 MongoDB 服务端。
? 关键点：insertMany 是 MongoDB Server 端的原子批量操作，服务端可优化内存分配、WAL 写入及索引更新，吞吐量远高于逐条 insertOne。
❌ 不存在的“批处理配置项”
你无法（也无需）在 application.yml 中配置如下类 JPA 的参数：
# ❌ 无效！Spring Data MongoDB 不识别这些属性 spring.data.mongodb.properties.hibernate.jdbc.batch_size=1000 spring.data.mongodb.order_inserts=true
原因在于：MongoDB 驱动层无“PreparedStatement”或“JDBC Batch”概念；所有批量逻辑均由 com.mongodb.client.MongoCollection.insertMany() 封装，Spring 层仅负责数据映射与调用编排。
⚠️ 注意事项与最佳实践
-
控制批量大小：虽然 insertMany 性能优异，但单次提交过多文档（如 > 100,000）可能引发内存压力或超时。建议按 1000–10000 条/批次 分片处理：
List<List<User>> batches = Lists.partition(users, 5000); batches.forEach(batch -> mongoTemplate.insertMany(batch, "users"));
-
事务内批量写入：若需事务保障（4.0+），insertMany 可在 ClientSession 中执行，确保原子性：
template.executeInSession(session -> { MongoCollection<Document> collection = session.getDatabase("test").getCollection("users"); collection.insertMany(documents); // 支持事务 return null; }); 避免误用 saveAll 或 insert 循环：
mongoTemplate.saveAll() 本质是循环调用 save()，非批量操作；同理，手动 for-loop + insert() 会产生 N 次网络往返，严重降低性能。
✅ 总结
Spring Data MongoDB 的批量插入不是“需要开启的功能”，而是默认启用的底层能力。只要使用 insertMany()（或 Repository 层的 saveAll() 配合自定义实现），你就已获得 MongoDB 原生的高性能批量写入。无需配置、无需插件、无需魔改——理解驱动层行为，善用官方 API，才是高效落地的关键。
