MongoDB校园ERP系统同校课程名称唯一约束实现方案咨询

核心思路 #

使用MongoDB的复合唯一索引实现多字段组合的唯一性约束，从数据库层面保证同一学校下课程名不重复，性能和可靠性远高于应用层手动查询校验。

实现步骤 #

1. 调整Course Schema，新增所属学校关联字段
   当前的Course文档未存储所属学校标识，无法做范围唯一性校验，首先需要新增school_id字段关联对应学校：

// SCHOOL SCHEMA（原有逻辑无需改动）
const SchoolSchema = mongoose.Schema({
  course: [{ 
    type: mongoose.Schema.Types.ObjectId,
    ref: 'course'
  }]
})

// 调整后的Course Schema
const CourseSchema = mongoose.Schema({
  course_name: {
    type: String,
    required: true
  },
  // 新增所属学校ID，关联School集合
  school_id: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'school',
    required: true
  }
})

2. 创建复合唯一索引
   在Course Schema上声明course_name和school_id的组合唯一索引：

CourseSchema.index({ course_name: 1, school_id: 1 }, { unique: true });

该索引生效后，MongoDB会自动校验：同一school_id下不允许存在相同的course_name，不同学校的同名课程不受任何限制，完全匹配业务需求。

注意事项 #

• 新增/修改课程时必须传入合法的school_id，否则约束不生效
• 如果Course集合已有历史数据，需要先清理掉同一学校下重复的课程名数据，再创建索引，否则索引会创建失败
• 触发唯一约束时MongoDB会抛出错误码为11000的异常，业务层可直接捕获该错误返回“当前学校已存在同名课程”的友好提示
• 数据库层面的约束天然支持并发场景，不会出现应用层手动校验可能存在的并发穿透问题（多个相同请求同时查询无数据后重复插入）

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