如何在Keystone.js中处理重复条目错误：友好提示与HTTP状态码返回

嘿，这个问题问得特别实用！你当前用的post-save钩子虽然能捕获重复键错误，但确实没法同时满足Keystone Admin界面的友好提示需求和API的标准HTTP状态码返回要求。我给你分享两种更合适的方案：

方案一：预保存验证+自定义错误类型（灵活可控） #

这种方式在数据保存前就完成重复检查，比post-save更高效（避免了Mongo的写入回滚），还能分别给Admin和API返回不同的错误处理结果：

步骤1：定义自定义错误类 #

先创建一个带状态码的自定义错误，方便API层识别：

class UniqueRegistrationError extends Error {
  constructor(email) {
    super(`${email} is already registered`);
    this.name = 'UniqueRegistrationError';
    this.statusCode = 409; // 冲突状态码
  }
}

步骤2：添加预保存验证钩子 #

在你的Registration List里添加pre-save钩子，提前检查重复：

Registration.schema.pre('save', async function(next) {
  // 查找是否已有相同邮箱的注册记录
  const existing = await Registration.findOne({ email: this.email });
  
  // 注意：更新操作时要排除当前文档本身
  if (existing && existing._id.toString() !== this._id.toString()) {
    throw new UniqueRegistrationError(this.email);
  }
  
  next();
});

步骤3：分别处理Admin与API的错误 #

• Keystone Admin：默认会捕获validate阶段的错误，并在界面上显示你抛出的错误消息，不需要额外配置，用户就能看到友好提示。
• API端点：在你的API路由里捕获自定义错误，返回对应状态码：

// 示例API注册路由
app.post('/api/registrations', async (req, res) => {
  try {
    const registration = await Registration.create(req.body);
    res.status(201).json({ data: registration });
  } catch (err) {
    if (err.name === 'UniqueRegistrationError') {
      res.status(err.statusCode).json({ error: err.message });
    } else {
      res.status(500).json({ error: 'Internal server error' });
    }
  }
});

方案二：利用Keystone内置唯一约束+全局错误处理（简洁高效） #

Keystone支持直接给字段设置unique: true，结合全局错误处理钩子，可以区分Admin和API请求，分别返回友好提示和状态码：

步骤1：给字段添加唯一约束 #

在定义Registration List时，给email字段加上unique: true：

Registration.add({
  email: { type: Types.Email, required: true, unique: true },
  // 其他字段...
});

步骤2：配置全局错误处理 #

在Keystone的初始化配置里添加onError钩子，区分Admin和API请求：

const keystone = new Keystone({
  // 其他配置（比如数据库连接、session等）
  onError: (err, req, res, next) => {
    // 判断是否为API请求
    const isApiRequest = req.path.startsWith('/api/');
    
    if (err.name === 'MongoError' && err.code === 11000) {
      // 解析重复的字段（这里从Mongo错误中提取）
      const duplicateField = Object.keys(err.keyPattern)[0];
      const errorMsg = `${duplicateField} is already in use`;
      
      if (isApiRequest) {
        // API请求：返回409状态码和JSON错误
        res.status(409).json({ error: errorMsg });
      } else {
        // Admin界面：用flash消息展示友好提示，跳回原页面
        req.flash('error', 'This email is already registered. Please try another one.');
        res.redirect('back');
      }
    } else {
      // 处理其他错误
      if (isApiRequest) {
        res.status(500).json({ error: err.message });
      } else {
        next(err);
      }
    }
  },
});

方案对比 #

• 方案一更灵活：适合需要复杂验证逻辑（比如除了邮箱还要检查其他字段组合唯一）的场景。
• 方案二更简洁：利用Keystone内置功能，减少自定义代码，适合简单的单字段唯一验证。

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