MongoDB判定复合索引重复的关键字段有5项：key（字段名及方向）、collation、partialFilterExpression、unique、sparse；仅这五项完全一致才视为重复，其余如name、background、expireAfterSeconds等不影响判定。
判断复合索引重复的关键字段有哪些
MongoDB 判定两个复合索引是否重复，**不看名字、不看 background 设置、也不看 expireAfterSeconds**，只比对直接影响查询行为的字段。真正起决定作用的是以下几项：key（字段名+方向）、collation、partialFilterExpression、unique、sparse。只要这五项完全一致，就算重复——哪怕一个叫 idx_user_email_v1，另一个叫 user_email_compound。
-
key必须字段顺序和方向（1或-1）完全相同：{name: 1, email: -1}和{name: 1, email: 1}不重复；{email: 1, name: 1}和{name: 1, email: 1}也不重复 -
collation缺失（即没写）和显式写{locale: "en"}视为不同；两个都写{locale: "zh"}才算一致 -
partialFilterExpression必须字面完全相等：{status: "active"}和{status: {$eq: "active"}}在 MongoDB 内部解析后可能不等价，脚本里不能靠字符串比较，得用JSON.stringify()+ 标准化处理 -
unique: true和unique: false（或未设）不算重复；sparse: true和sparse: false同理
为什么 background: true 不影响重复判定
因为 background 只控制建索引时是否阻塞写操作，不影响任何查询计划或匹配逻辑。MongoDB 查询优化器根本不会读这个字段——它只关心“哪些值能被快速定位”。所以你在清理冗余索引时，如果只对比 key 和 options 的原始 JSON，却没过滤掉 background、expireAfterSeconds、name 这些非语义字段，就会误判。
- 错误做法：直接
JSON.stringify(indexA.options) === JSON.stringify(indexB.options) - 正确做法：提取并标准化关键字段，例如：
{ unique: idx.unique, sparse: idx.sparse, collation: idx.collation, partialFilterExpression: idx.partialFilterExpression } - 特别注意：
collation为null或undefined时，要统一转为空对象或显式null，避免undefined !== null导致漏判
分片集群下唯一索引的“假重复”陷阱
在分片集群中，你可能看到多个分片上存在一模一样的 {url: 1} 唯一索引，但它们**不算重复索引**——因为每个分片上的索引是独立实体。MongoDB 的重复索引检测工具（如 db.collection.getIndexes() 返回结果）只作用于单个分片或副本集主节点，不会跨分片聚合比较。
- 如果你在 mongos 上执行
db.collection.getIndexes()，拿到的是所有分片索引的合并视图，但字段缺失（比如没有host或shard标识），无法区分来源 - 真正要查“全局重复”，得连到每个分片单独跑
db.collection.getIndexes()，再逐个比对——否则容易把合法的分片级索引当成冗余 - 更隐蔽的问题：
unique: true索引在分片集群中本就只保证分片内唯一，不是设计用来防跨分片重复的；别指望靠删“重复索引”解决数据重复问题
实操：用脚本安全比对两个索引定义
别手写 if 嵌套判断，直接用结构化提取+标准化比较。下面这段逻辑可嵌入 Node.js 或 Python 脚本中：
function normalizeIndex(idx) {
return {
key: Object.entries(idx.key).map(([k, v]) => [k, v]),
unique: !!idx.unique,
sparse: !!idx.sparse,
collation: idx.collation || null,
partialFilterExpression: idx.partialFilterExpression ? JSON.stringify(idx.partialFilterExpression) : null
};
}
const a = normalizeIndex(indexA);
const b = normalizeIndex(indexB);
const isDuplicate = JSON.stringify(a) === JSON.stringify(b);
-
Object.entries().map()确保key字段顺序固定，避免对象属性遍历顺序差异导致误判 -
JSON.stringify()对partialFilterExpression是必须的——否则{a: 1}和{a: {$eq: 1}}在 JS 对象层面不等，但 MongoDB 认为等价 - 实际运行时，建议加日志输出
a和b的字符串值，方便 debug 时一眼看出哪一项不一致
collation 和 partialFilterExpression 的隐式空值处理——它们不像 unique 那样有明确布尔默认值，而是完全缺失或 null，稍不注意就让两个本该重复的索引逃过检测。 
