本文介绍如何在 express + mongodb 应用中，通过异步并发方式安全获取所有专辑数据，并为每个专辑动态添加其包含的歌曲总数，最终返回格式统一、字段完整的 json 响应。
本文介绍如何在 express + mongodb 应用中，通过异步并发方式安全获取所有专辑数据，并为每个专辑动态添加其包含的歌曲总数，最终返回格式统一、字段完整的 json 响应。
在构建音乐播放器后端时，常需提供 /explore/albums 这类聚合接口：它不仅要返回专辑基础信息（如名称、封面、艺术家等），还需附带该专辑下歌曲的数量。由于 MongoDB 中专辑（Albums）与歌曲（Songs）通常采用松耦合设计（例如歌曲文档中仅存 album: "Album Name" 字段而非 ObjectId 引用），无法直接通过 $lookup 聚合（除非使用引用式建模），此时需在应用层完成“一对多”计数逻辑。
关键挑战在于避免阻塞式循环（如 for...of 串行查询）导致性能劣化，同时解决原始代码中 .map(async () => {}) 返回的是 Promise 数组却未 await Promise.all() 的典型错误——这会导致 res.json(albums) 实际发送的是未解析的 Promise 对象数组（表现为空或 [{}, {}, ...]）。
✅ 正确做法是：先批量查出所有专辑，再并行统计每张专辑的歌曲数，最后合并结果。以下是优化后的完整实现：
Router.route("/explore/albums")
.get(async (req, res) => {
try {
// Step 1: 获取全部专辑（不带 songs 字段）
const albums = await _Albums.find().lean(); // .lean() 提升性能，返回 Plain Object
// Step 2: 并行统计每张专辑的歌曲数量（推荐使用 countDocuments 而非 find().length）
const albumsWithSongs = await Promise.all(
albums.map(async (album) => {
const numberOfSongs = await _Songs.countDocuments({ album: album.name });
// 合并原始专辑字段与新增的 numberOfSongs（确保响应结构清晰）
return {
...album,
numberOfSongs
};
})
);
// Step 3: 统一返回标准 JSON 响应
res.json(albumsWithSongs);
} catch (e) {
console.error("Failed to fetch albums with song counts:", e);
res.status(500).json({
error: "Internal Server Error",
message: "Unable to load album data"
});
}
});? 关键优化说明：
- 使用 .lean() 使 find() 返回纯 JavaScript 对象，避免 Mongoose 文档包装开销，提升序列化速度；
- 用 countDocuments() 替代 find(...).length：前者只计数不加载文档，内存友好且更快；
- Promise.all() 确保所有计数请求并发执行，大幅缩短总耗时（N 张专辑 ≈ 单次数据库往返延迟，而非 N 次）；
- 显式错误处理与 HTTP 状态码返回（如 500），增强 API 可靠性与前端调试体验。
⚠️ 注意事项：
- 若专辑名存在大小写混用或空格差异，建议在查询前对 album.name 做标准化（如 .trim().toLowerCase()），并在数据库中建立对应索引（db.songs.createIndex({ album: 1 })）以加速 countDocuments；
- 当专辑量极大（如 >10k）时，可考虑改用 MongoDB 聚合管道 + $lookup（需歌曲表含 albumId ObjectId 引用）或预计算字段（如每次增删歌曲时更新专辑的 songCount），避免实时聚合压力。
此方案兼顾简洁性、性能与可维护性，适用于中等规模音乐库场景，是 Node.js + MongoDB 全栈开发中的典型数据聚合实践。
