本文介绍如何在使用 mongodb java 同步驱动（v4+）时，为自定义 pojo 类（如 user）的特定字段（如 userid）创建唯一索引，确保插入时自动校验唯一性，避免重复数据。
本文介绍如何在使用 mongodb java 同步驱动（v4+）时，为自定义 pojo 类（如 user）的特定字段（如 userid）创建唯一索引，确保插入时自动校验唯一性，避免重复数据。
在 Java 中通过 MongoCollection
✅ 正确实现方式（推荐）
首先确保已引入必要依赖（以 Maven 为例）：
<dependency><groupid>org.mongodb</groupid><artifactid>mongodb-driver-sync</artifactid><version>4.12.1</version><!-- 建议使用最新稳定版 --></dependency>
然后在初始化集合后（例如首次启动或建表阶段），调用 createIndex() 创建唯一索引：
import com.mongodb.client.MongoCollection;
import com.mongodb.client.model.IndexOptions;
import com.mongodb.client.model.Indexes;
import static com.mongodb.client.model.Filters.eq;
// 获取泛型集合（User 类需有正确注解或默认序列化支持）
MongoCollection<user> userCollection = db.getCollection("users", User.class);
// 创建唯一索引：对 userID 字段升序建立唯一索引
IndexOptions uniqueIndexOptions = new IndexOptions().unique(true);
userCollection.createIndex(Indexes.ascending("userID"), uniqueIndexOptions);</user>
? 说明：
- Indexes.ascending("userID") 生成标准的 Bson 索引键 { "userID": 1 }；
- new IndexOptions().unique(true) 等价于 Shell 中的 { unique: true }；
- 此操作只需执行一次（通常在应用初始化阶段），重复执行无副作用（索引已存在则忽略）。
⚠️ 注意事项与最佳实践
- 索引创建时机：建议在应用启动时（如 Spring @PostConstruct、或主函数初始化逻辑中）创建索引，而非每次 addUser() 调用时执行，避免性能损耗和并发风险。
-
异常处理：插入重复 userID 时，驱动将抛出 MongoWriteException，其原因可通过 getError().getCode() 判断（错误码 11000 表示重复键）。应捕获并转换为业务友好的提示：
try { userCollection.insertOne(user); } catch (MongoWriteException e) { if (e.getError().getCode() == 11000) { throw new IllegalArgumentException("用户ID已存在：" + user.getUserID()); } throw e; } - POJO 序列化兼容性：确保 User 类字段名与 MongoDB 存储字段一致（默认按 Java 字段名映射）。如需自定义映射（如 userID → _id 或 user_id），可使用 @BsonProperty("user_id") 注解。
-
复合唯一索引（扩展）：若需多字段联合唯一（如 userID + tenantId），可使用：
userCollection.createIndex( Indexes.compoundIndex( Indexes.ascending("userID"), Indexes.ascending("tenantId") ), new IndexOptions().unique(true) );
✅ 总结
MongoDB 的唯一性保障必须由数据库层索引实现，Java 驱动不提供运行时字段级“唯一”注解（如 JPA @Column(unique=true)）。只要正确使用 Indexes.* 工具方法配合 IndexOptions.unique(true)，即可在强类型 MongoCollection
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
