MongoDB Spring Boot Mongo – E11000 唯一键冲突问题

在本文中，我们将介绍如何解决 MongoDB Spring Boot 应用中的唯一键冲突问题。在使用 MongoDB 数据库时，经常会遇到唯一键（唯一索引）冲突的情况，本文将介绍如何处理这种情况并提供示例说明。

阅读更多：MongoDB 教程

什么是唯一键冲突问题

唯一键是指在一个集合（collection）中，某个字段的值必须唯一。当我们向数据库插入数据时，如果插入的数据中存在与已有记录中的唯一键相同的值，就会发生唯一键冲突。这会导致插入操作失败，返回 E11000 错误码。

解决唯一键冲突问题的方法

有两种常见的方法可以解决 MongoDB Spring Boot 应用中的唯一键冲突问题：一种是在应用层面处理，另一种是通过 MongoDB 提供的特性实现。

在应用层面处理

在应用层面处理唯一键冲突问题的方法主要有以下几种：

检查数据是否已存在：在插入数据之前，先通过查询操作检查数据库中是否已经存在相同唯一键的记录。如果存在，则不执行插入操作，避免冲突。

示例代码：

public void insertData(User user) {
    Query query = new Query(Criteria.where("username").is(user.getUsername()));
    if (mongoOperations.exists(query, User.class)) {
        throw new DuplicateKeyException("Username already exists.");
    }
    mongoOperations.insert(user);
}

使用乐观锁实现并发安全：在更新操作中使用版本号（version）或时间戳等字段作为乐观锁，当发生唯一键冲突时，更新操作将失败，并返回错误信息。

示例代码：

public void updateUser(User user) {
    Query query = new Query(Criteria.where("username").is(user.getUsername()));
    Update update = new Update().set("email", user.getEmail()).inc("version", 1);
    FindAndModifyOptions options = FindAndModifyOptions.options().returnNew(true).upsert(false);
    User updatedUser = mongoOperations.findAndModify(query, update, options, User.class);
    if (updatedUser == null) {
        throw new DuplicateKeyException("Username does not exist.");
    }
}

使用 MongoDB 提供的特性

除了在应用层面处理唯一键冲突问题，MongoDB 还提供了一些特性用于解决这个问题：

唯一索引：在集合中创建一个唯一索引，保证字段的唯一性。当插入操作中出现唯一键冲突时，MongoDB 会自动抛出 E11000 错误码。

示例代码：

db.users.createIndex({ username: 1 }, { unique: true })

在 Spring Boot 中可以通过使用 @Indexed 注解来创建唯一索引。

Upsert 操作：在更新数据时，如果数据不存在则插入新的数据，如果存在则更新已有数据。可以利用 Upsert 操作来检查唯一键冲突并处理。

示例代码：

public void upsertUser(User user) {
    Query query = new Query(Criteria.where("username").is(user.getUsername()));
    Update update = new Update().set("email", user.getEmail());
    UpdateResult result = mongoOperations.upsert(query, update, User.class);
    if (result.getModifiedCount() == 0) {
        throw new DuplicateKeyException("Username already exists.");
    }
}