MongoServerError E11000重复键错误排查求助

核心原因分析 #

• MongoServerError: E11000 重复键错误指向email字段空值重复，说明User Schema中email字段被设置了唯一索引，但部分Google OAuth返回的用户数据未携带email，多次插入空值触发唯一约束。
• 若Passport回调逻辑中未正确调用done()、未捕获异步异常，会导致请求挂起或重复执行用户创建逻辑，即使删除集合也会重复报错。

分步排查与修复 #

1. 修正User Schema的索引配置 #

先检查你的User Schema，常见错误是给email加了unique: true但未处理空值场景：

// 错误示例：未处理空值的Schema
const userSchema = new mongoose.Schema({
  email: { type: String, unique: true },
  googleId: String
});

修复方案：改用googleId作为唯一标识（OAuth用户的核心唯一凭证），同时处理email空值问题：

// 修复后的Schema
const userSchema = new mongoose.Schema({
  email: { 
    type: String, 
    unique: true,
    sparse: true, // 允许空值不触发唯一约束，仅对非空值校验唯一性
    default: function() { return this.googleId ? `${this.googleId}@google.oauth` : null; }
  },
  googleId: { type: String, required: true, unique: true }, // 核心唯一标识
  displayName: String
});

注意：若之前已创建集合，需手动删除旧的email唯一索引：
在MongoDB Shell执行：db.users.dropIndex("email_1")，重启应用使新索引生效。

2. 修复Passport Google策略的回调逻辑 #

确保回调中仅在用户不存在时创建，且无论成功/失败都调用done()，同时捕获数据库异常避免应用崩溃：

// 错误示例：未处理空值、未捕获异常、可能遗漏done()
passport.use(new GoogleStrategy({
    clientID: process.env.GOOGLE_CLIENT_ID,
    clientSecret: process.env.GOOGLE_CLIENT_SECRET,
    callbackURL: "/auth/google/callback"
  },
  async (accessToken, refreshToken, profile, done) => {
    const email = profile.emails?.[0]?.value;
    let user = await User.findOne({ googleId: profile.id });
    if (!user) {
      user = await User.create({ googleId: profile.id, email: email });
    }
    done(null, user);
  }
));

修复后的回调：

passport.use(new GoogleStrategy({
    clientID: process.env.GOOGLE_CLIENT_ID,
    clientSecret: process.env.GOOGLE_CLIENT_SECRET,
    callbackURL: "/auth/google/callback"
  },
  async (accessToken, refreshToken, profile, done) => {
    try {
      // 优先用googleId查询，避免email为空导致的问题
      let user = await User.findOne({ googleId: profile.id });
      
      if (!user) {
        // 处理email为空的情况，生成临时邮箱避免空值
        const email = profile.emails?.[0]?.value || `${profile.id}@google.oauth`;
        user = await User.create({ 
          googleId: profile.id, 
          email: email,
          displayName: profile.displayName
        });
      }
      // 必须调用done，无论用户是否存在
      done(null, user);
    } catch (err) {
      // 捕获数据库异常，传递错误给Passport，避免应用崩溃
      done(err, null);
    }
  }
));

关键要点：

• 用googleId作为用户唯一标识，比email更可靠（部分Google账号可能不返回email）。
• 用try/catch包裹异步逻辑，捕获重复键等数据库错误。
• 确保所有分支最终都调用done()，避免请求挂起导致重复执行。

3. 检查Auth路由配置 #

确保路由未重复挂载，且OAuth请求包含email权限：

// Auth.js 正确示例
router.get("/google", passport.authenticate("google", { scope: ["profile", "email"] })); // 必须请求email权限

router.get("/google/callback", 
  passport.authenticate("google", { failureRedirect: "/login" }),
  (req, res) => {
    res.redirect("/dashboard");
  }
);

4. 验证步骤 #

1. 删除MongoDB中的users集合：db.users.drop()
2. 重启应用，确保新索引生效
3. 用Google账号登录，检查数据库用户记录，确认email不为空、googleId唯一

内容的提问来源于stack exchange，提问作者sultan.h