Node.js/Express+MongoDB/Mongoose API无法写入name属性至数据库

问题描述 #

我正在用Node.js/Express、MongoDB搭配Mongoose开发一个带分类的简易购物清单API，但遇到了两个棘手的问题：

1. 调用分类POST路由创建新分类时，name属性始终无法插入数据库，返回的分类对象里name值为undefined；
2. 使用物品POST路由创建新物品时，接口直接返回空对象。

作为新手我卡在这里好久了，希望能得到大家的帮助。以下是我的index.js核心代码：

var express = require("express"), 
    app = express(), 
    bodyParser = require("body-parser"), 
    mongoose = require("mongoose"), 
    mongodb = require("mongodb"), 
    ejs = require("ejs"), 
    engine = require("ejs-mate"), 
    port = process.env.PORT, 
    ip = process.env.ip;

// 使用body parser
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

// Mongoose数据库连接
mongoose.connect("mongodb://localhost/shop", { useMongoClient: true });
mongoose.Promise = Promise;

// 分类Schema
var catSchema = new mongoose.Schema({
 name:{ type: String },
 items: [{ type: mongoose.Schema.Types.ObjectId, ref: "Item" }]
});
var Category = mongoose.model("Category", catSchema);

// 分类POST路由
app.post("/api/categories", function(req, res){
 Category.create(req.body)
 .then(function(newCategory){
 res.send(newCategory);
 console.log(newCategory.name);
 })
 .catch(function(err){
 res.send(err);
 });
});

app.listen(port, function(){
 console.log("App is running on port: "+ port);
});

问题排查与解决方案 #

一、分类name未插入的问题 #

我从你的代码里找到了几个可能的原因，按优先级排查：

1. 确认请求体是否正确传递name字段
   先在路由里加一行日志，打印接收到的请求体：

   app.post("/api/categories", function(req, res){
     console.log("接收到的请求体：", req.body); // 新增这行
     Category.create(req.body)
     // ... 其他代码
   });
   

   如果打印结果里没有name，说明前端发送请求的格式有问题：

   • 用Postman测试时，要选对请求体格式：如果是表单提交选x-www-form-urlencoded，如果是JSON选raw并设置格式为JSON；
   • 前端代码里要确保请求头设置了Content-Type: application/json（如果发JSON），或者正确拼接表单数据。

2. 显式指定插入字段，避免隐式错误
   虽然Category.create(req.body)可以直接传递对象，但显式提取字段能避免请求体里的冗余字段干扰，同时更直观：

   app.post("/api/categories", function(req, res){
     Category.create({ name: req.body.name })
     .then(function(newCategory){
       res.send(newCategory);
       console.log(newCategory.name);
     })
     .catch(function(err){
       res.status(400).send(err); // 加上错误状态码，更符合REST规范
     });
   });
   

3. 修复Mongoose连接配置
   你用的useMongoClient是Mongoose旧版本的配置项，现在已经被废弃了，换成新版的连接配置能避免潜在的连接异常：

   mongoose.connect("mongodb://localhost/shop", { 
     useNewUrlParser: true, 
     useUnifiedTopology: true 
   })
   .then(() => console.log("MongoDB连接成功"))
   .catch(err => console.error("MongoDB连接失败：", err));
   

二、物品POST路由返回空对象的问题 #

你没贴物品相关的代码，但根据现象推测大概率是这几个原因：

1. 未正确定义Item模型
   确保你已经创建了Item的Schema和模型，比如：

   // 物品Schema示例
   var itemSchema = new mongoose.Schema({
     name: String,
     quantity: Number,
     category: { type: mongoose.Schema.Types.ObjectId, ref: "Category" }
   });
   var Item = mongoose.model("Item", itemSchema);
   

2. 替换body-parser为Express内置解析器
   Express 4.16+已经内置了body-parser的功能，不需要单独安装依赖，替换成以下代码能避免版本兼容问题：

   // 替换原来的body-parser代码
   app.use(express.json());
   app.use(express.urlencoded({ extended: true }));
   

3. 确保物品路由正确处理请求
   参考分类路由的写法，显式处理请求体并返回结果：

   app.post("/api/items", function(req, res){
     Item.create({
       name: req.body.name,
       quantity: req.body.quantity,
       category: req.body.categoryId
     })
     .then(newItem => res.send(newItem))
     .catch(err => res.status(400).send(err));
   });
   

额外开发建议 #

• 开发时多打印日志：比如req.body、数据库操作的错误详情，能快速定位问题；
• 检查MongoDB服务是否启动：可以在终端执行mongod命令确认服务状态；
• 给Schema字段加基础验证：比如name: { type: String, required: true }，这样Mongoose会自动验证字段是否存在，错误信息也会更明确。

内容的提问来源于stack exchange，提问作者random-xyz