使用MongoDB Mongoose无法保存文档到数据库，求技术解决方案

模型代码（user.model.js） #

const mongoose = require("mongoose");

const UserSchema = new mongoose.Schema(
  {
    name: {
      type: String,
      required: true,
    },

    username: {
      type: String,
      required: true,
    },

    email: {
      type: String,
      required: true,
    },

    password: {
      type: Number,
      required: true,
    },
  },

  {
    timestamps: true,
  }
);

const User = new mongoose.model("User", UserSchema);
module.exports = User;

控制器代码 #

const User = require("../model/user.model");

const signup = async (req, res) => {
  const { name, username, email, password } = req.body;
  const data = User({
    name: name,
    username: username,
    email: email,
    password: password,
  });

  try {
    await data.save();
    res.status(200).json("Data Submitted");
  } catch (error) {
    console.log(error);
    res.status(401).json("Failed");
  }
};

module.exports = signup;

排查与解决要点 #

1. 密码字段类型错误
   模型中password字段定义为Number类型，但实际密码（包括哈希后的密码）都是字符串格式。如果请求中传入的是字符串密码，Mongoose会因类型不匹配拒绝保存。
   修复：将模型中password字段类型改为String：

password: {
  type: String,
  required: true,
},

2. 未建立MongoDB连接
   如果应用未正确连接MongoDB，调用save()会直接抛出错误。检查连接代码，确保服务器启动前完成数据库连接：

const mongoose = require("mongoose");

mongoose.connect("mongodb://localhost:27017/your-db-name")
  .then(() => console.log("Connected to MongoDB"))
  .catch(err => console.error("MongoDB connection error:", err));

3. 未配置请求体解析中间件
   使用Express框架时，必须配置express.json()解析JSON请求体，否则req.body会是undefined，触发必填字段验证失败。在入口文件添加：

const express = require("express");
const app = express();

app.use(express.json());

4. 错误日志不够详细
   当前控制器仅打印error对象，无法定位具体问题。修改catch块输出详细错误信息：

catch (error) {
  console.error("Save error:", error.message);
  res.status(400).json({ message: "Failed", error: error.message });
}

控制台会显示具体错误原因（如字段缺失、类型不匹配、连接失败等）。

5. 可选优化：添加唯一约束
   若需保证email或username唯一性，在模型中添加unique: true：

email: {
  type: String,
  required: true,
  unique: true,
},
username: {
  type: String,
  required: true,
  unique: true,
},

注意需确保数据库中无重复数据，否则会触发唯一性验证错误。

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