MongoDB查询文档属性访问返回undefined问题求助

问题场景 #

在MongoDB中存储球队数据，前端通过点击事件将选中的id发送至后端/api/folder接口，意图更新数据。后端控制台打印的team对象中明确包含game1:5，但直接访问team.game1却返回undefined，无法完成自增1的更新操作。

后端代码 #

import db from "@/utils/db";
import Team from '@/modules/Team'

const handler = async (req, res) => {
  
  console.log(req.body)    // { id: '64501115948ae9070cdd5ba5' }

  await db.connect();

  const team = await Team.findById(req.query.id);

  console.log('team', team)
  console.log('name', team.name)
  console.log('game', team.game1)
  
  team.game1 += 1

  await team.save()

  await db.disconnect(); 
  res.status(200).json({ message: 'success '})
};

export default handler

终端输出 #

{ id: '64501115948ae9070cdd5ba5' }
use previous connection
team {
  _id: new ObjectId("64501115948ae9070cdd5ba5"),
  name: 'Boston',
  img: '/bos.png',
  color: '#0800ff',
  updatedAt: 2023-05-02T16:32:57.387Z,
  game1: 5,              // 要修改的字段
  game2: 0,
  game3: 0,
  game4: 0,
  game5: 0,
  game6: 0,
  game7: 0
}
name Boston Bruins
game undefined    // 此处返回undefined

原因分析 #

1. Mongoose Schema未定义对应字段：MongoDB本身无Schema约束，但Mongoose是强Schema模型。如果Team模型的Schema中未声明game1到game7字段，Mongoose会将这些字段存储到数据库，但不会把它们映射为Document实例的可访问属性——控制台能打印出来是因为输出的是原始数据库文档，而直接访问属性时会被Mongoose的Schema过滤。
2. ID获取方式潜在不匹配：前端将id放在请求body中，但后端用req.query.id获取，虽然本次查询成功，但属于前后端参数传递逻辑不一致的隐患。

修复方案 #

方案1：修正Mongoose Schema #

在Team模型的Schema定义中添加缺失的字段，示例：

// modules/Team.js
import mongoose from 'mongoose';

const teamSchema = new mongoose.Schema({
  name: String,
  img: String,
  color: String,
  game1: { type: Number, default: 0 },
  game2: { type: Number, default: 0 },
  game3: { type: Number, default: 0 },
  game4: { type: Number, default: 0 },
  game5: { type: Number, default: 0 },
  game6: { type: Number, default: 0 },
  game7: { type: Number, default: 0 },
  updatedAt: { type: Date, default: Date.now }
});

export default mongoose.models.Team || mongoose.model('Team', teamSchema);

方案2：改用原子更新操作（更高效） #

跳过查询文档的步骤，直接用Mongoose的findByIdAndUpdate完成原子自增，避免Schema映射问题：

import db from "@/utils/db";
import Team from '@/modules/Team'

const handler = async (req, res) => {
  await db.connect();

  // 统一ID获取逻辑：优先取body中的id，兼容query传递的情况
  const teamId = req.body.id || req.query.id;
  await Team.findByIdAndUpdate(teamId, { $inc: { game1: 1 } });

  await db.disconnect(); 
  res.status(200).json({ message: 'success '})
};

export default handler

方案3：临时访问原始文档（不修改Schema） #

如果暂时不想调整Schema，可以通过toObject()获取原始JS对象后再修改：

const teamDoc = team.toObject();
teamDoc.game1 += 1;
await Team.findByIdAndUpdate(team._id, teamDoc);

额外建议 #

• 统一前后端参数传递逻辑：如果用POST请求，就固定把id放在body中；如果用GET请求，就放在query里，避免混淆。
• 优先使用MongoDB的原子操作符（如$inc），减少数据库交互次数，同时避免并发更新导致的数据不一致问题。

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