如何在SpringBoot中为MongoDB添加约束，避免同一用户多条活跃记录

要满足「每个username仅允许一条active=true的记录，active=false记录无限制」的需求，你需要给MongoDB的user集合创建部分唯一复合索引，核心是通过partialFilterExpression指定约束生效的条件。

方法一：通过Spring Data MongoDB注解自动创建索引 #

直接在你的User实体类上添加@CompoundIndex注解，指定索引字段和过滤条件：

@Data
@Document(collection="user")
@CompoundIndex(name = "username_active_unique", def = "{'username': 1, 'active': 1}", partialFilterExpression = "{'active': true}")
public class User{
    @Id
    private long id;
    private String username;
    private String sessionId;
    private boolean active;
}

• name：自定义索引名称，方便后续维护
• def：指定索引的字段（username升序，active升序）
• partialFilterExpression：仅当active=true时，该唯一索引生效

方法二：手动在MongoDB Shell创建索引 #

如果需要手动操作数据库（比如生产环境直接执行），可以运行以下命令：

db.user.createIndex(
    { username: 1, active: 1 },
    { 
        name: "username_active_unique",
        partialFilterExpression: { active: true },
        unique: true
    }
)

注意事项 #

1. 数据预检查：创建索引前，需确保现有数据中没有重复的username且active=true的记录，否则索引创建会失败。可以先执行查询清理重复数据：

   # 找出重复的active=true记录
   db.user.aggregate([
       { $match: { active: true } },
       { $group: { _id: "$username", count: { $sum: 1 } } },
       { $match: { count: { $gt: 1 } } }
   ])
   

2. 异常处理：当并发保存违反约束的记录时，Spring Data MongoDB会抛出DuplicateKeyException，你需要在服务层捕获该异常并处理（比如返回错误提示、更新现有active=true的记录等）。

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