MongoDB创建文本索引时报WiredTiger错误问题咨询

第一步：先获取完整错误信息 #

你当前看到的是WiredTiger存储层的通用报错片段，需要先查看完整的MongoDB日志条目，定位后面附带的具体错误码和描述，才能精准判断是资源问题、数据问题还是配置问题。 #

第二步：分维度排查触发原因 #

• 存储资源类排查
  3000万行量级的文本索引体积通常为原集合的15%~50%，首先确认两个资源阈值：
  • 数据盘剩余空间是否小于集合总大小的50%，空间不足会直接触发存储写入报错
  • WiredTiger缓存配置是否足够：默认缓存为系统内存的50%，如果缓存小于集合总大小的20%，大索引构建时会因为内存置换频繁触发存储层错误
• 数据合规性排查
  即使你提前做了CSV清洗，也需要确认MongoDB内存储的字段是否符合文本索引要求：
  • 检查event字段单值长度是否超过1024字节（MongoDB文本索引默认的单Key长度上限），执行以下命令统计超限文档：

  db.mycollection.find({ $expr: { $gt: [ { $strLenBytes: "$event" }, 1024 ] } })
  

  • 检查event字段是否存在非字符串类型的异常值，执行以下命令排查：

  db.mycollection.find({ event: { $not: { $type: "string" } } })
  

• 索引构建模式排查
  默认前台索引构建会锁住集合，且占满IO资源，3000万行量级的集合用前台构建极容易触发IO超限、超时类的存储错误。

第三步：对应解决方案 #

• 资源不足问题：扩容数据盘保证剩余空间至少为集合总大小的2倍，临时调大WiredTiger缓存到系统内存的70%，索引构建完成后可调回原值
• 数据不合规问题：
  1. 对超长度的event字段可选择截断，或者添加参数忽略超限文档继续构建：

  db.mycollection.createIndex({event: "text"}, { failIndexKeyTooLong: false })
  

  2. 对非字符串类型的异常值统一清洗为字符串格式后再构建索引
• 构建模式问题：改用后台构建模式，IO占用更平缓且不会锁集合：

db.mycollection.createIndex({event: "text"}, { background: true })

4.2及以上版本MongoDB推荐使用更稳定的滚动构建方式：

db.mycollection.createIndex({event: "text"}, { commitQuorum: "votingMembers" })

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