为何Promise未返回更新后的记录？NodeJS API表单提交问题

咱们一步步来拆解这个问题，大概率是下面几个环节出了疏漏：

1. Mongoose更新操作未配置返回更新后文档的选项 #

这是最常见的坑！Mongoose的findByIdAndUpdate、updateOne这类更新方法，默认不会返回更新后的文档——要么返回旧文档，要么返回包含更新统计信息的对象（比如nModified字段），不会直接给你更新后的记录。

如果你的updateBoard函数里用的是这类方法，必须加上{ new: true }选项（Mongoose 6+版本也可以用returnOriginal: false，效果一致）：

错误写法（拿不到更新后文档）：

module.exports.updateBoard = function(obj) {
  return Board.findByIdAndUpdate(obj.idBoard, obj.query);
}

正确写法（返回更新后的文档）：

module.exports.updateBoard = function(obj) {
  return Board.findByIdAndUpdate(obj.idBoard, obj.query, { new: true });
}

另外，如果用的是updateOne，它本身就不会返回文档，只会返回更新结果对象。这种情况下你需要先执行更新，再手动查询文档：

module.exports.updateBoard = function(obj) {
  return Board.updateOne({ _id: obj.idBoard }, obj.query)
    .then(() => Board.findById(obj.idBoard));
}

2. updateBoard函数的Promise链未正确传递值 #

如果你的updateBoard函数里有嵌套的then逻辑，但没把结果正确返回出去，外部的Promise就拿不到值。比如：

错误写法（没返回Promise链）：

module.exports.updateBoard = function(obj) {
  Board.findByIdAndUpdate(obj.idBoard, obj.query, { new: true })
    .then(doc => {
      console.log('更新后的文档:', doc);
      // 这里没return，外部then拿不到结果
    });
  // 函数没返回任何Promise，外部调用时then会拿到undefined
}

正确写法（返回整个Promise链并传递结果）：

module.exports.updateBoard = function(obj) {
  return Board.findByIdAndUpdate(obj.idBoard, obj.query, { new: true })
    .then(doc => {
      console.log('更新后的文档:', doc);
      return doc; // 把结果传递给外部的then
    });
}

3. 路由中缺少错误处理逻辑 #

你当前的路由代码只处理了成功的情况，但如果updateBoard抛出错误（比如idBoard不存在、更新路径无效），Promise会进入catch分支，但你没处理，导致请求可能挂起，或者返回空响应。

赶紧加上错误处理，这样能快速定位问题：

.post('/create/card', function (req, res) { 
  var rb = req.body, obj = { 
    query: { 
      $set: { ['lists.' + rb.cardIndex + '.cards']: rb.cards }, 
      $push: { activity: { $each: [rb.activity], $position: 0 } } 
    }, 
    idBoard: rb.idBoard 
  } 
  Board.updateBoard(obj) 
    .then((updated) => { res.send(updated); })
    .catch(err => {
      console.error('更新失败:', err);
      res.status(500).send({ error: '更新失败', details: err.message });
    })
})

4. 请求体解析是否配置正确 #

别忘了确认你的Express服务器已经配置了解析JSON请求体的中间件，否则req.body会是undefined，导致updateBoard找不到对应的文档，自然返回空。

在服务器入口文件里加上：

const express = require('express');
const app = express();
app.use(express.json()); // 解析JSON格式的请求体

5. 更新路径是否符合文档结构 #

检查['lists.' + rb.cardIndex + '.cards']这个路径是否和你的Board文档结构匹配。比如：

• 如果lists是数组，rb.cardIndex必须是有效的数字索引（比如0、1），不能是字符串或者超出数组长度
• 如果lists是对象，那这个路径写法没问题，但要确保rb.cardIndex是对象的有效键

如果路径无效，Mongoose不会抛出错误，但也不会更新文档，导致返回的还是旧数据。

内容的提问来源于stack exchange，提问作者Bartłomiej Flis