Mongoose错误处理：应在Node.js端还是客户端解析错误？

绝对推荐在Node.js后端处理Mongoose的错误，再把格式化后的友好消息返回给客户端，而不是让客户端自己解析。原因和具体实现方法如下：

为什么选后端处理？ #

• 安全性优先：Mongoose原生错误会包含数据库结构（比如集合名、字段名）、甚至连接细节等敏感信息，如果直接返回给客户端，可能泄露系统架构，带来安全风险。
• 维护成本更低：所有错误处理逻辑集中在后端，后续要修改错误文案、调整规则，只需要更新后端代码，不用同步修改多个客户端（Web、APP、小程序等）。
• 体验一致性：不同客户端拿到的错误消息格式完全统一，不用各自写一套解析逻辑，避免出现不同端错误提示不一致的情况。

如何在Node.js端实现友好错误返回？ #

以你提到的「公司名称/邮箱重复」为例，这属于Mongoose的唯一索引冲突错误（错误码11000），我们可以捕获这个错误，解析出重复的字段，转换成用户易懂的中文消息。

步骤1：先在Schema中设置唯一索引 #

const mongoose = require('mongoose');

const CompanySchema = new mongoose.Schema({
  name: { 
    type: String, 
    required: true, 
    unique: true,
    // 可选：自定义验证失败消息
    validate: {
      validator: async function(value) {
        const count = await this.constructor.countDocuments({ name: value });
        return count === 0;
      },
      message: '公司名称已存在'
    }
  },
  email: { 
    type: String, 
    required: true, 
    unique: true,
    validate: {
      validator: async function(value) {
        const count = await this.constructor.countDocuments({ email: value });
        return count === 0;
      },
      message: '公司邮箱已存在'
    }
  }
});

const Company = mongoose.model('Company', CompanySchema);

步骤2：捕获并处理错误（两种方式） #

方式一：在单个路由中处理

app.post('/api/companies', async (req, res) => {
  try {
    const newCompany = new Company(req.body);
    await newCompany.save();
    res.status(201).json({ success: true, data: newCompany });
  } catch (err) {
    // 处理唯一索引冲突错误
    if (err.code === 11000) {
      const duplicateField = Object.keys(err.keyPattern)[0];
      const fieldAlias = { name: '公司名称', email: '公司邮箱' };
      res.status(400).json({ 
        success: false, 
        error: `错误：${fieldAlias[duplicateField]}已存在` 
      });
    } 
    // 处理Mongoose验证错误（比如必填字段为空）
    else if (err.name === 'ValidationError') {
      const errorList = Object.values(err.errors).map(item => item.message);
      res.status(400).json({ 
        success: false, 
        error: `错误：${errorList.join('、')}` 
      });
    } 
    // 其他未知错误
    else {
      res.status(500).json({ 
        success: false, 
        error: '服务器内部错误，请稍后重试' 
      });
    }
  }
});

方式二：用全局错误中间件（更推荐，复用性高）

// 全局错误处理中间件，放在所有路由之后
app.use((err, req, res, next) => {
  // 处理唯一索引冲突
  if (err.code === 11000) {
    const duplicateFields = Object.keys(err.keyPattern);
    const fieldAlias = { name: '公司名称', email: '公司邮箱' };
    const errorMsg = duplicateFields.map(field => `${fieldAlias[field]}已存在`).join('、');
    return res.status(400).json({ success: false, error: `错误：${errorMsg}` });
  }

  // 处理Mongoose验证错误
  if (err.name === 'ValidationError') {
    const errorMsg = Object.values(err.errors).map(e => e.message).join('、');
    return res.status(400).json({ success: false, error: `错误：${errorMsg}` });
  }

  // 其他错误返回通用提示
  res.status(500).json({ success: false, error: '服务器内部错误，请稍后重试' });
});

客户端的工作 #

客户端只需要接收后端返回的error字段，直接展示给用户即可，不用做任何复杂的解析。比如前端拿到响应后：

// 前端示例（React）
const createCompany = async (data) => {
  try {
    const res = await fetch('/api/companies', {
      method: 'POST',
      body: JSON.stringify(data),
      headers: { 'Content-Type': 'application/json' }
    });
    const result = await res.json();
    if (!result.success) {
      alert(result.error); // 直接弹出"错误：公司名称已存在"这类消息
      return;
    }
    // 处理成功逻辑
  } catch (err) {
    alert('网络异常，请稍后重试');
  }
};

这样既安全，又能给用户提供清晰易懂的错误提示，同时维护起来也方便。

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