如何在MongoDB中创建不区分大小写的唯一复合索引？

问题根源 #

你尝试用**文本索引（text index）**实现唯一约束是行不通的：文本索引的设计目的是用于全文搜索，会对字段内容做分词、大小写归一化等处理，但本身不支持唯一约束；直接给文本索引加unique: true会因为索引内部的处理逻辑触发重复键错误，完全不符合你的需求。

正确解决方案：复合唯一索引+大小写不敏感排序规则（Collation） #

MongoDB的**排序规则（Collation）**可以指定字符串比较时的大小写敏感度，结合复合唯一索引就能实现你要的效果：在tenant_id和seller_id相同的前提下，seller_sku_code不区分大小写唯一。

1. 创建索引

执行以下命令创建带collation的复合唯一索引：

db.your_collection.createIndex(
  { tenant_id: 1, seller_id: 1, seller_sku_code: 1 },
  {
    unique: true,
    collation: {
      locale: "en",
      strength: 2 // 忽略大小写，保留重音、特殊字符等差异
    }
  }
)

• strength: 2是核心配置：该值表示字符串比较时忽略大小写，但会保留其他字符差异（比如"ACC-2001"和"ACC-2000"会被视为不同），完全匹配你的需求。
• 若业务需要忽略重音（比如不区分"é"和"e"），可将strength设为1，普通场景用2即可。

2. 清理已有重复数据

如果集合中已存在tenant_id+seller_id相同、seller_sku_code大小写不同的重复数据，创建索引会直接触发你之前遇到的E11000错误，需先清理重复项：

• 用聚合查询定位重复数据：

db.your_collection.aggregate([
  {
    $group: {
      _id: {
        tenant_id: "$tenant_id",
        seller_id: "$seller_id",
        sku_lower: { $toLower: "$seller_sku_code" }
      },
      duplicates: { $push: "$_id" },
      count: { $sum: 1 }
    }
  },
  { $match: { count: { $gt: 1 } } }
])

• 根据业务逻辑删除多余重复文档，比如保留最早创建的条目：

// 遍历聚合结果，删除重复项（需根据实际业务调整）
db.your_collection.aggregate([/* 上述聚合查询语句 */]).forEach(doc => {
  doc.duplicates.shift(); // 保留第一个文档，移除其余ID
  db.your_collection.deleteMany({ _id: { $in: doc.duplicates } });
})

3. 验证约束效果

创建索引后，测试以下场景：

• 插入{ tenant_id: 1, seller_id: 1, seller_sku_code: "ABC" } → 成功
• 再插入{ tenant_id: 1, seller_id: 1, seller_sku_code: "abc" } → 抛出E11000重复键错误（符合预期）
• 插入{ tenant_id: 1, seller_id: 1, seller_sku_code: "ACC-2001" } → 成功
• 插入{ tenant_id: 1, seller_id: 2, seller_sku_code: "ABC" } → 成功（seller_id不同，不受约束）

4. 注意事项

• 执行查询、更新或删除操作时，若需依赖该大小写不敏感的约束逻辑，建议在操作中指定相同的collation，确保行为一致：

db.your_collection.find(
  { tenant_id: 1, seller_id: 1, seller_sku_code: "abc" },
  { collation: { locale: "en", strength: 2 } }
)

• 若同时需要对seller_sku_code做全文搜索，可单独创建一个文本索引，与该唯一索引分开使用，二者互不影响。

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