本文揭示了使用 mongoose 时因误用 promise 对象导致字段被存为 {} 的根本原因，并通过修正 await 位置、避免 json.stringify() 包裹 promise 等关键操作，帮助开发者正确保存字符串与数组类型数据。
本文揭示了使用 mongoose 时因误用 promise 对象导致字段被存为 {} 的根本原因，并通过修正 await 位置、避免 json.stringify() 包裹 promise 等关键操作，帮助开发者正确保存字符串与数组类型数据。
在 Node.js + Mongoose 开发中，一个高频却隐蔽的错误是：本应保存为字符串（String）或数组（Array）的字段，最终在 MongoDB 中却显示为空对象 {}。问题往往并非模型定义有误，而是异步数据流处理不当——尤其是将未 await 的 Promise 直接传入 JSON.stringify() 或模型字段。
回顾原始代码，核心问题出现在 seedDB() 函数中：
const Bloodborne = new Game({
title: JSON.stringify(fetchGameData([0]).then(value => console.log(value))),
summary: JSON.stringify(fetchGameData([1]).then(value => console.log(value))),
artworks: JSON.stringify(fetchGameData([2]).then(value => console.log(value)))
});这段代码存在两个严重问题：
- fetchGameData([0]) 返回的是一个 Promise，而非实际值；
- JSON.stringify() 作用于 Promise 对象时，会序列化其内部结构（通常为空对象 {}），而非等待解析后的结果。
✅ 正确做法：必须先 await 获取异步函数的真实返回值，再进行字符串化或直接赋值。
✅ 正确写法（推荐）
const seedDB = async () => {
await connectDB();
await Game.deleteMany({});
// ✅ 关键：先 await 获取真实数据，再赋值
const title = await fetchGameData(0); // 注意：此处索引应为数字 0，非数组 [0]
const summary = await fetchGameData(1);
const artworks = await fetchGameData(2);
const Bloodborne = new Game({
title: typeof title === 'string' ? title : String(title),
summary: typeof summary === 'string' ? summary : String(summary),
artworks: Array.isArray(artworks) ? artworks : []
});
await Bloodborne.save();
console.log('✅ Game "Bloodborne" seeded successfully!');
};? 补充优化建议
-
修复 fetchGameData 的参数逻辑：原函数接收 index 但内部却对整个响应数组循环推入扁平化数据（push(resp.name, resp.summary, resp.artworks)），这会导致 gameData[0] 是第一个游戏的 name，gameData[1] 是同一游戏的 summary……但若 API 返回多条记录，索引将错位。更健壮的方式是返回完整对象并解构：
const fetchGameData = async () => { try { const response = await axios.post('https://api.igdb.com/v4/games/', gameQuery, config); const game = response.data[0]; // 取首条匹配结果 return { title: game?.name || '', summary: game?.summary || '', artworks: Array.isArray(game?.artworks) ? game.artworks : [] }; } catch (err) { console.error('Failed to fetch game data:', err); throw err; } }; // 调用时： const { title, summary, artworks } = await fetchGameData(); -
Mongoose 模型应启用严格模式与类型校验：
const gameSchema = new mongoose.Schema({ title: { type: String, required: true, trim: true }, summary: { type: String, default: '' }, artworks: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Artwork' }] // 或直接用 [{ url: String }] }, { strict: true }); 避免无意义的 JSON.stringify()：除非你明确需要存储 JSON 字符串（如日志快照），否则对 title/summary 调用 JSON.stringify() 是冗余且危险的——它会把 "Bloodborne" 变成 '"Bloodborne"'（带双引号的字符串）。仅当字段需存为 JSON 格式（如配置项）时才使用。
⚠️ 注意事项总结
- await 必须作用于 Promise 本身，不能放在 .then() 链内再传给同步函数；
- JSON.stringify(Promise) → {}，JSON.stringify(await Promise) → 实际值的 JSON 字符串；
- 始终校验异步返回值类型（typeof, Array.isArray()），防止 null/undefined 导致意外行为；
- 使用 console.log() 调试时，确保打印的是 await 后的值，而非 Promise 实例。
遵循以上实践，即可彻底规避“字段变空对象”问题，确保 Mongoose 数据持久化精准可靠。
