Node.js + MongoDB API问题：书籍数据无法正确写入数据库

看起来你遇到了MongoDB文档只生成_id和__v但不写入实际书籍信息的问题，我之前也碰到过类似情况，下面是几个最常见的排查方向和解决办法：

1. 确认是否解析了POST请求的JSON体 #

如果你的Express项目没有配置express.json()中间件，服务器会无法解析请求中的JSON格式数据，导致req.body为空对象。这时候创建文档自然只有MongoDB自动生成的_id和版本键__v。

解决方案：在你的主入口文件（比如app.js或server.js）中添加以下代码：

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

// 必须添加这行来解析JSON请求体
app.use(express.json());

2. 检查Schema字段与请求体字段是否匹配 #

这是最容易踩坑的点：如果你的MongoDB Schema定义的字段名和POST请求传入的JSON键不一致（比如大小写、命名方式不同），MongoDB会忽略不匹配的字段，只保存Schema中定义的字段（如果请求里没传，就不会写入）。

举个例子，假设你的Schema是这样的：

const mongoose = require('mongoose');
const bookSchema = new mongoose.Schema({
  title: { type: String, required: true },
  author: { type: String, required: true },
  publicationYear: Number
});

module.exports = mongoose.model('Book', bookSchema);

那你的POST请求body必须严格对应这些字段：

{
  "title": "MongoDB实战指南",
  "author": "张三",
  "publicationYear": 2024
}

如果请求里传的是bookTitle而不是title，那这个字段就不会被写入数据库。

3. 确认创建文档时正确传递了请求数据 #

检查你的POST路由代码，是否将req.body的数据正确传递给了Book模型实例：

错误示例：只创建了空实例，没有传入数据

app.post('/books', (req, res) => {
  // 这里创建了空的Book实例，自然只有默认字段
  const newBook = new Book();
  newBook.save()
    .then(() => res.send('书籍已成功打印'))
    .catch(err => console.log(err));
});

正确示例：传入请求体数据或者手动赋值

app.post('/books', async (req, res) => {
  try {
    // 方式1：直接传入req.body（确保字段匹配）
    const newBook = new Book(req.body);
    const savedBook = await newBook.save();
    res.json(savedBook);
  } catch (err) {
    // 捕获错误并返回，方便排查问题
    res.status(400).json({ error: err.message });
  }
});

// 或者手动赋值（适合需要对数据做预处理的场景）
app.post('/books', async (req, res) => {
  try {
    const newBook = new Book({
      title: req.body.title,
      author: req.body.author,
      publicationYear: req.body.publicationYear
    });
    const savedBook = await newBook.save();
    res.json(savedBook);
  } catch (err) {
    res.status(400).json({ error: err.message });
  }
});

4. 检查错误捕获逻辑 #

如果你的代码没有正确捕获save()方法的错误，可能会出现“成功提示”但实际保存失败的情况（比如Schema中必填字段未传入）。一定要添加错误捕获，这样能快速定位问题。

比如上面的正确示例中，我们用try/catch捕获了异步错误，并将错误信息返回给客户端，这样你就能知道是哪里出了问题（比如“Path title is required”）。

关于GET请求异常 #

GET请求返回异常大概率是因为POST请求没有正确写入数据，导致数据库中只有空文档或者没有文档。解决上面的POST问题后，再测试GET请求应该就能正常返回书籍数据了。

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