Mongoose save方法异常返回空{}对象的Node.js Auth API问题

核心问题原因及修复 #

• 缺失Express请求体解析中间件（最高发问题）
  未配置JSON请求体解析时，req.body默认值为undefined，构造User实例时传入的name/email/password全为空，触发Schema必填校验失败。直接返回Mongoose错误对象时，因Error对象存在循环引用，JSON序列化后会变成空对象{}，前端看不到具体报错。
  修复方式：在Express入口文件（app.js/index.js）的路由挂载代码前，添加以下中间件：

  // 解析JSON格式请求体
  app.use(express.json());
  // 解析x-www-form-urlencoded格式请求体
  app.use(express.urlencoded({ extended: true }));
  

• Schema字符串长度校验字段写法错误
  现有代码中字符串类型字段使用了min/max做长度限制，这两个属性仅对数字类型字段生效，字符串长度校验需使用minlength/maxlength，否则校验逻辑不会按预期执行。
  修复后的User Schema：

  const mongoose = require('mongoose');
  
  const userSchema = new mongoose.Schema({
      name: {
          type: String,
          required: true,
          minlength: 6,
          maxlength: 255
      },
      email: {
          type: String,
          required: true,
          maxlength: 255,
          minlength: 6
      },
      password: {
          type: String,
          required: true,
          maxlength: 1024,
          minlength: 6
      },
      date: {
          type: Date,
          default: Date.now
      }
  });
  
  const User = mongoose.model('User', userSchema);
  module.exports = User;
  

• 错误返回逻辑不规范，无法定位具体报错
  直接将Mongoose Error对象通过res.send()返回时，Express默认序列化逻辑无法完整输出错误信息，会出现空返回。另外直接返回存储的用户文档会泄露密码哈希等敏感信息，存在安全风险。
  修复路由的错误捕获和成功返回逻辑：

  const router = require('express').Router();
  const User = require('../model/User');
  
  router.post('/register', async (req, res) => {
      const user = new User({
          name: req.body.name,
          email: req.body.email,
          password: req.body.password
      });
  
      try{
          const savedUser = await user.save();
          // 过滤敏感字段后再返回
          res.send({
              userId: savedUser._id,
              name: savedUser.name,
              email: savedUser.email
          });
      }catch(err){
          res.status(400).send({
              errorMsg: err.message,
              validateErrors: err.errors
          });
      }
  })
  
  module.exports = router;
  

• MongoDB连接异常未处理
  若MongoDB服务未启动、连接字符串配置错误（端口、账号密码、数据库名写错），会导致数据库连接失败，save()操作无法正常执行。
  排查方式：在Mongoose连接代码中添加状态日志，确认服务启动时数据库连接正常：

  mongoose.connect('你的MongoDB连接字符串')
    .then(() => console.log('MongoDB连接成功'))
    .catch(connErr => console.log('MongoDB连接失败：', connErr))
  

• 请求格式不符合要求
  调用接口时需确认请求头设置了Content-Type: application/json，传入的JSON格式合法，且name/email/password三个必填字段均传值、长度符合规则。

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