使用C#插入MongoDB时序数据短时后触发异常问题排查

一、DuplicateKey（错误码11000）异常处理 #

• 核心原因：测试用的id字段被设为唯一索引（不管是手动创建还是误将其作为_id使用），插入时生成的id出现重复，触发唯一键冲突。
• 解决方法：
  • 移除唯一索引：如果是手动给id建了唯一索引，执行db.collection.dropIndex("id_1")；如果是自己指定的_id重复，要么改成让MongoDB自动生成_id，要么重新设计id生成逻辑（比如用雪花算法、UUID加时间戳组合），保证全局唯一。
  • 批量插入容错：调用InsertManyAsync时设置IsOrdered = false，这样单条数据插入失败不会中断整个批次；同时捕获MongoWriteException，筛选出重复键的记录，要么跳过，要么重新生成id后重试。

二、不完整时序插入失败问题 #

• 可能原因：
  • 单批插入数据量过大，超过MongoDB的单批大小限制，导致部分数据插入失败。
  • 网络波动或MongoDB节点负载过高（比如磁盘IO、内存占用超标），引发插入请求超时或中断。
• 解决方法：
  • 拆分批次：把每秒1万条的插入量拆成更小的批次（比如每批1000条），降低单批插入的压力，避免触发MongoDB的限流机制。
  • 重试机制：针对插入失败的批次，实现指数退避重试逻辑，同时区分失败原因——是重复键就处理id，是网络或负载问题就延迟重试。
  • 监控MongoDB状态：查看MongoDB日志，确认是否存在连接池耗尽、资源不足等问题，针对性调整配置（比如增大连接池大小、优化索引、扩容节点）。

三、重建连接无效，需重启应用的问题 #

• 核心原因：应用的MongoDB连接池在异常后出现资源泄漏或连接失效，无法自动回收，导致新请求复用失效连接。
• 解决方法：
  • 优化连接池配置：设置合理的最大连接数、连接超时、空闲超时时间，让连接池能自动清理失效连接。
  • 异常后重置连接池：捕获插入异常后，主动调用MongoDB客户端的连接池重置方法，强制重建有效连接，不要手动创建新的MongoClient实例（重复创建实例会导致连接池混乱）。
  • 完善异常处理：所有数据库操作都要加try-catch，避免未处理的异常导致连接资源无法释放，确保连接池始终处于健康状态。

内容的提问来源于stack exchange，提问作者Danil