Spring Data MongoDB 本身不提供类似 JPA 的 JDBC 批处理配置项，其批量插入本质依赖 insertMany() 驱动级原生支持，开发者只需合理调用 API 即可获得高效批量写入能力。
spring data mongodb 本身不提供类似 jpa 的 jdbc 批处理配置项，其批量插入本质依赖 `insertmany()` 驱动级原生支持，开发者只需合理调用 api 即可获得高效批量写入能力。
在 Spring Boot 应用中集成 MongoDB 时，许多开发者会自然联想到 Spring Data JPA 中熟悉的批处理配置，例如：
spring.jpa.properties.hibernate.jdbc.batch_size=1000 spring.jpa.properties.hibernate.order_inserts=true
但需要明确的是：这些配置对 Spring Data MongoDB 完全无效——因为 MongoDB 并非关系型数据库，不使用 JDBC 驱动，也不存在“SQL 批量 INSERT 语句”的概念。
✅ MongoDB 批量插入的真实机制
Spring Data MongoDB 的批量写入能力由底层 MongoDB Java Driver 原生支持，核心是 MongoCollection.insertMany() 方法。MongoTemplate 提供的 insertMany()（或 doInsertBatch()）并非模拟循环插入，而是：
- 将实体列表统一转换为 Document 或 BsonDocument；
- 调用驱动层 insertMany(List
)； - 所有文档通过单次网络请求发送至 MongoDB 服务端；
- 服务端以原子性批量方式解析、校验并写入（支持事务上下文中的批量操作）。
这意味着：真正的“批处理”发生在驱动与服务端之间，而非 Spring 层面的 SQL 语句拼接或 PreparedStatement 复用。
✅ 正确启用批量插入的实践方式
无需任何 application.yml 配置项，只需在业务代码中显式调用批量方法：
@Service
public class ProductImportService {
@Autowired
private MongoTemplate mongoTemplate;
public void batchInsertProducts(List<Product> products) {
// 自动映射为 Document 并执行 insertMany
mongoTemplate.insert(products, "products");
// 或更明确地指定集合：
// mongoTemplate.insertMany(products, Product.class);
}
}? 提示：mongoTemplate.insert(List
) 内部即委托至 insertMany()，等效于手动调用 mongoTemplate.getCollection("collectionName").insertMany(documents)。
⚠️ 注意事项与性能建议
- 避免小批量高频调用：即使单次 insertMany 很快，频繁触发（如每次仅传 5 条）仍会带来显著网络开销。建议按业务场景聚合为 100–1000 条/批次（具体需结合文档大小与网络延迟压测调整）。
- 禁用自动索引更新？不推荐：MongoDB 不支持像 MySQL 那样临时禁用索引。如需极致导入性能，可考虑在数据导入前临时删除非必要索引，导入完成后再重建（生产环境慎用，需配合维护窗口）。
- 错误处理策略：insertMany 默认为“全部成功或全部失败”（ordered=true）。若需容忍部分失败，可传入 InsertManyOptions.ordered(false)，此时失败项将被单独抛出 MongoBulkWriteException，可通过 getWriteErrors() 获取明细。
- 事务内批量写入：在 @Transactional 方法中调用 insertMany，可确保与其他操作（如更新日志、状态变更）强一致性（要求 MongoDB ≥ 4.0 + 副本集/分片集群）。
? 总结
Spring Data MongoDB 的“批量插入”不是靠配置开启的功能，而是一种默认启用、开箱即用的底层优化行为。与其寻找不存在的 spring.data.mongodb.batch-size 属性，不如聚焦于：
- 使用 insertMany() / insert(List
) 替代循环 save()； - 合理控制单批次数据量，平衡内存占用与网络效率；
- 结合 InsertManyOptions 和异常处理提升健壮性；
- 在高吞吐场景下，配合异步线程池或 Spring Batch 分片任务进行横向扩展。
真正高效的 MongoDB 批处理，始于对驱动能力的信任，成于对 API 语义的准确理解。
