17370845950

本文详解在 node.js api 开发中，如何基于匹配字段（如 `roomcode`/`room`）将房间基础信息与可用性数据精准关联，生成带嵌套 `dates` 数组的多维响应结构，并指出常见属性名不一致导致的空数组陷阱。

在构建酒店或度假村类 API 时，常需将静态房间元数据（如房型、面积、床型）与动态可用性数据（如每日余量、积分价格）进行关联渲染。你提供的案例中，rooms 数组包含 roomcode 字段，而 room_availability 数组对应使用的是 room 字段——二者字段名不同但语义相同，这是导致 filter 返回空数组的根本原因。

你的原始代码：

dates: room_availability.filter(f => f.roomcode == item.roomcode)

由于 room_availability 中每个对象并无 roomcode 属性（只有 room），该条件恒为 false，因此所有 dates 均为空数组 []。

✅ 正确写法应统一匹配字段名：

const combined = rooms.map(room => ({
  ...room,
  dates: room_availability.filter(availability => availability.room === room.roomcode)
}));

? 提示：推荐使用严格相等 === 替代 ==，避免隐式类型转换引发意外行为（例如字符串 "ZA" 与数字 0 的误判）。

进阶优化建议

1. 使用 Map 预处理提升性能（适用于大数据量）

若 room_availability 数据量较大（如数百条以上），多次 filter 会造成 O(n×m) 时间复杂度。可先构建 room → availability[] 映射：

const availabilityMap = new Map();
for (const avail of room_availability) {
  const key = avail.room;
  if (!availabilityMap.has(key)) {
    availabilityMap.set(key, []);
  }
  availabilityMap.get(key).push(avail);
}

const combined = rooms.map(room => ({
  ...room,
  dates: availabilityMap.get(room.roomcode) || []
}));

此方式将时间复杂度优化至 O(n + m)，显著提升响应速度。

2. 添加容错与日志（生产环境必备）

const combined = rooms.map(room => {
  const matches = room_availability.filter(a => a.room === room.roomcode);
  if (matches.length === 0) {
    console.warn(`No availability found for roomcode: ${room.roomcode}`);
  }
  return { ...room, dates: matches };
});

3. 完整路由示例（含错误处理）

app.get("/resort-info/room-availability/start/:start/end/:end", async (req, res) => {
  try {
    const [rooms, room_availability] = await Promise.all([
      getRooms(),
      getRoomAvailability(req.params.start, req.params.end)
    ]);

    const combined = rooms.map(room => ({
      ...room,
      dates: room_availability.filter(a => a.room === room.roomcode)
    }));

    res.json(combined); // 推荐使用 .json() 自动设置 Content-Type
  } catch (err) {
    console.error("Room-availability merge failed:", err);
    res.status(500).json({ error: "Failed to load room availability" });
  }
});

总结

• ? 核心要点：确保关联字段名完全一致（room_availability.room vs rooms.roomcode）；
• ⚡ 性能关键：对高频查询场景，优先用 Map 预聚合替代重复 filter；
• ?️ 健壮性：增加缺失匹配日志与异常捕获，便于线上问题排查；
• ? 输出规范：使用 res.json() 而非 res.send()，确保符合 RESTful API 最佳实践。

通过以上调整，你的 /resort-info/room-availability/... 接口即可稳定输出符合预期的多维嵌套结构，为前端提供开箱即用的房间+日期维度数据。