如何在 Node.js 中高效构建 JSON 响应中嵌套字段的键值映射

本文详解如何从结构为 {“28338”: { “high”: 696000000, …}, … } 的 API 响应中，精准提取每个顶层键对应的 high 值，生成 Map 或普通对象映射，解决因忽略响应嵌套层级（如 data 字段）导致的 undefined 问题。

本文详解如何从结构为 {“28338”: {“high”: 696000000, …}, …} 的 api 响应中，精准提取每个顶层键对应的 high 值，生成 map 或普通对象映射，解决因忽略响应嵌套层级（如 data 字段）导致的 undefined 问题。

在 Node.js 中处理大型 JSON 响应时，常见误区是直接对整个响应体调用 Object.keys() 或 Object.entries()，而忽略了真实数据实际位于响应的某个子属性下（例如 response.data）。你遇到的 myList 输出为 {data: undefined}，根本原因正是：API 返回的 JSON 并非扁平对象，而是形如 {code: 200, data: { “28338”: { high: …, low: …}, … } } 的结构 。因此，jsonResponse 本身不含 “28338” 这样的键，jsonResponse.data 才是目标数据源。

以下是推荐的健壮实现方案：

✅ 正确解析与映射（使用 Object.fromEntries + 解构）

async function fetchItemHighPrices() {   const url = 'https://prices.runescape.wiki/api/v1/osrs/latest';    try {     const response = await fetch(url);     if (!response.ok) {throw new Error(`HTTP error! status: ${response.status}`);     }      const jsonResponse = await response.json();      // 关键修正：访问 jsonResponse.data 而非 jsonResponse     if (!jsonResponse.data || typeof jsonResponse.data !== 'object') {throw new Error('Invalid API response: missing or invalid "data" field');     }      // 构建 {"28338": 696000000, "28337": ……, ……} 映射     const priceMap = Object.fromEntries(Object.entries(jsonResponse.data).map(([itemId, itemData]) => [itemId,         itemData.high // 安全访问：若需容错可写 itemData?.high ?? null])     );      return priceMap;   } catch (error) {console.error('Failed to fetch or parse prices:', error);     throw error;   } }  // 使用示例 (async () => {try {     const highPrices = await fetchItemHighPrices();     console.log(`Mapped ${Object.keys(highPrices).length} items`);     // 示例输出： {"28338": 696000000, "28337": 521000000, ……}      // 后续可用于批量更新 SQLite     // for (const [itemId, highPrice] of Object.entries(highPrices)) {//   await db.run('UPDATE items SET itemValue = ? WHERE itemID = ?', highPrice, itemId);     // }   } catch (err) {console.error(err);   } })();

? 关键要点说明

• 层级意识 ：始终检查 API 文档或 console.log(jsonResponse) 确认数据所在路径（本例为 jsonResponse.data）；
• 性能考量 ：Object.fromEntries() + map() 比 reduce() 更语义清晰且性能相当，适用于 28,000+ 条目；
• 错误防御 ：
  • 检查 HTTP 状态码；
  • 验证 jsonResponse.data 是否存在且为对象；
  • 对 itemData.high 使用可选链 itemData?.high 可进一步避免运行时错误（若部分条目缺失 high 字段）；
• 类型安全（TypeScript 提示）：

  interface ItemData {high: number; low: number; highTime: number; lowTime: number;} type PriceMap = Record<string, number>;

? 为什么你原来的代码返回 {data: undefined}？

因为 return Object.keys(jsonResponse).reduce(…) 实际遍历的是 jsonResponse 的顶层键（如 “code”、”data”、”timestamp”），而 jsonResponse[“data”] 是一个对象，其自身键才是 “28338”。你试图对 jsonResponse（而非 jsonResponse.data）做映射，自然无法得到预期结果。

掌握这一层级访问逻辑，即可稳定构建大规模键值映射，为后续数据库批量操作（如 UPDATE items SET itemValue = ? WHERE itemID = ?）提供可靠数据基础。