本文详解如何将房间基础信息数组与房态可用性数组按 `roomcode`/`room` 字段精准关联，生成嵌套多维结构，解决因字段名不一致导致的空匹配问题，并提供可直接用于 express api 的健壮实现方案。
在构建酒店或度假村类 API 时，常需将静态房间元数据（如房型、面积、图片路径）与动态房态数据（如每日可订数量、积分价格）进行结构化聚合。你当前遇到的核心问题是：room_availability 数组中用于匹配的字段名为 room，而非 roomcode——而你在 .filter() 中错误地使用了 f.roomcode == item.roomcode，导致所有 dates 子数组为空。
✅ 正确匹配逻辑
观察数据结构可知：
- rooms 数组中每个对象含 roomcode: "ZA" 等字段；
- room_availability 数组中对应字段是 room: "ZA"（非 roomcode），且 resort 值为 "BWALK"（注意与 rooms.resort === "Boardwalk Villas" 不完全一致，但本例中匹配仅依赖 room 字段）。
因此，只需修正过滤条件中的键名：
app.get("/resort-info/room-availability/start/:start/end/:end", async (req, res) => {
try {
const rooms = await getRooms();
const start = req.params.start;
const end = req.params.end;
const room_availability = await getRoomAvailability(start, end);
// ✅ 关键修复：使用 f.room（而非 f.roomcode）匹配 item.roomcode
const combined = rooms.map(room => ({
...room,
dates: room_availability.filter(availability =>
availability.room === room.roomcode
)
}));
res.json(combined); // 推荐使用 .json() 而非 .send()，自动设置 Content-Type
} catch (error) {
console.error("Room-availability merge failed:", error);
res.status(500).json({ error: "Failed to merge room data" });
}
});⚙️ 进阶优化建议
1. 提升性能：预建哈希索引
若 room_availability 数据量较大（如数百个房型 × 数百天），多次 filter() 会带来 O(n×m) 时间复杂度。推荐预先构建以 room 为键的 Map：
const availabilityMap = new Map();
room_availability.forEach(item => {
const key = item.room;
if (!availabilityMap.has(key)) {
availabilityMap.set(key, []);
}
availabilityMap.get(key).push(item);
});
const combined = rooms.map(room => ({
...room,
dates: availabilityMap.get(room.roomcode) || [] // 安全回退空数组
}));2. 增强鲁棒性：字段标准化与容错
- 统一 resort 字段：若后续需按度假村名称关联，建议在 getRooms() 或 getRoomAvailability() 中做映射（如 "BWALK" → "Boardwalk Villas"）；
- 忽略大小写匹配（如 availability.room.toLowerCase() === room.roomcode.toLowerCase()）；
- 添加日志验证匹配结果：console.log(Room ${room.roomcode} matched ${combined[i].dates.length} dates);
3. API 设计最佳实践
- 使用 res.json() 替代 res.send()，明确响应类型；
- 添加错误处理（如上例所示），避免未捕获异常导致服务崩溃；
- 对日期参数做基础校验（如 isValidDate(start) && isValidDate(end)）。
? 总结
该问题本质是对象属性名认知偏差——开发中务必仔细比对源数据字段命名。一次 f.roomcode → f.room 的修正，即可让嵌套结构正确生成。结合 Map 预处理与错误防护，你的 /room-availability 接口将兼具正确性、性能与稳定性，为前端提供开箱即用的多维房间数据视图。
