哈希索引不支持唯一约束，因其仅存储哈希值而不保留原始值，无法校验重复；正确做法是显式存哈希值并为其创建普通唯一索引。
哈希索引不能加 unique: true，强行指定会报错 Cannot specify unique:true for a hashed index。想靠哈希索引实现设备指纹去重，这条路走不通。
为什么哈希索引不支持唯一约束
MongoDB 的哈希索引只对字段值做哈希运算后建 B-tree，它不保留原始值顺序，也无法在索引节点中校验重复原始值——而唯一性检查必须基于原始值比对。所以内核直接禁止了 { unique: true } 与哈希索引共存。
- 哈希索引适用于
find({ field: value })等精确匹配，但不支持范围查询、排序、部分匹配 - 唯一约束依赖索引能逐条比对原始字段值，哈希索引做不到这点
- 即使你用
db.collection.createIndex({ fingerprint: "hashed" }, { unique: true })，mongosh 会立刻拒绝并提示错误
正确做法：哈希字段 + 单独唯一索引
想兼顾查询速度和去重，得拆成两步：先用哈希加速查询，再用普通升序索引 enforce 唯一性。实际建模时，建议显式存哈希值，而不是依赖 "hashed" 类型。
- 插入前计算指纹哈希（如 SHA-256），存为
fingerprint_hash字段 - 给
fingerprint_hash建普通升序索引并启用唯一：db.devices.createIndex({ fingerprint_hash: 1 }, { unique: true }) - 查询时直接
find({ fingerprint_hash: "abc123..." })，走索引，毫秒级响应 - 重复插入会触发
duplicate key error，应用层捕获11000错误码即可处理
设备指纹字段设计的现实坑点
真实设备指纹不是单个字符串，而是多维特征拼接（如 UA + screen + canvas + webgl + timezone），拼接方式直接影响去重效果。
- 不要用
JSON.stringify()直接序列化对象——键顺序不保证，相同设备可能生成不同哈希 - 推荐标准化后再拼接：按字段名排序，固定格式序列化（如
canvas:${v}&screen:${w}x${h}&ua:${hash(ua)}） - 注意数组字段（如
fonts）需先排序再 join，否则顺序差异导致哈希不等价 - 浏览器隐私策略（如 User-Agent Client Hints 替代传统 UA）会导致同一设备在不同时间生成不同指纹，需评估是否纳入“稳定指纹”范畴
去重逻辑不能只靠数据库层
唯一索引只能防止完全相同的指纹重复写入，但无法解决语义重复问题——比如两个高度相似但哈希值不同的指纹，可能是同一设备在不同隐私模式下上报的。
这类情况必须前置处理：在入库前用布隆过滤器或 MinHash 做近似去重，或者用聚合管道定期跑 $group + $cond 合并相似指纹。数据库唯一索引只是最后一道防线，不是万能解。
