Object.groupBy 不能直接处理异步或非结构化数据，必须先 await 响应、解析 JSON、提取真实数组；键函数需安全 fallback 并统一类型；兼容性差且无流式支持，大规模场景应降级或改用增量统计。
Object.groupBy 不能直接用于异步响应或非结构化数据——它只接受已解析的数组，且要求键函数稳定、字段存在、类型一致。
为什么 fetch + Object.groupBy 会立即报错
常见错误现象是 TypeError: undefined is not iterable 或 Cannot use 'in' operator to search for 'length' in [object Promise]。根本原因是把 fetch() 返回的 Promise 当成了数组传给 Object.groupBy。它不接收异步流，也不解析 JSON，更不处理嵌套、缺失字段或混合类型。
必须先完成三步：await 响应 → 调用 .json()（或 .text() 后手动 JSON.parse）→ 提取真实数据数组（如 res.data 或 res.items）。
- 若后端返回的是 NDJSON（每行一个 JSON 对象），
Object.groupBy完全无法识别，得用ReadableStream+TextDecoder拆分后再逐行JSON.parse - 若响应体是字符串但不是合法 JSON（比如带 BOM、HTML 错误页、空格包裹），
.json()会直接 reject，必须加try/catch - 别在
fetch().then(res => Object.groupBy(res.json(), ...))里链式调用——res.json()返回 Promise，仍需 await
非结构化数据怎么提取可用分组键
“非结构化”常指字段名不统一（status / code / httpStatus）、嵌套层级深（response.detail.error.code）、或部分为 null/undefined。此时键函数极易返回 undefined，导致所有异常数据被塞进 undefined 组，掩盖真实分布。
安全写法是显式 fallback + 类型归一：
- 用可选链
x?.status ?? x?.code ?? x?.response?.detail?.code ?? 0避免报错 - 强制转字符串：
String(x?.status ?? 'unknown')，防止数字200和字符串"200"被当成两个键 - 若需语义分组（如把
401、403归为"auth"），先map映射再groupBy，别在键函数里写复杂逻辑
示例：
const data = await res.json(); const flatItems = Array.isArray(data) ? data : data.items ?? data.data ?? []; const grouped = Object.groupBy( flatItems, x => String(x?.status ?? x?.code ?? 'unknown') );
大规模数据下的性能与兼容性红线
当一次请求返回 5000+ 条日志，Object.groupBy 本身无性能瓶颈，但后续操作容易翻车：
- Chrome 117+、Safari 17.4+ 支持；Firefox 和 Edge ≤ 116 完全不支持，必须用
core-jspolyfill 或手写降级（reduce+Map） - 键函数里避免任何耗时操作：
new Date(x.ts).getDay()会被执行 N 次，状态码这种原始字段最稳 - 如果只是要统计各状态码数量，用
Map手动计数比Object.groupBy+Object.values().map(x => x.length)更省内存 - 不要对分组结果直接
JSON.stringify发送到前端——大数组嵌套深时可能触发 V8 内存限制
实时统计场景下真正该关注的点
所谓“实时”，往往不是靠 Object.groupBy 实现的，而是靠流式响应 + 增量更新。它只是一个同步分组工具，无法监听新数据、无法合并历史分组、也不支持取消或中断。
真要支撑持续流入的数据流，得配合其他机制：
- 用
EventSource或 WebSocket 接收逐条事件，每来一条就map到键、Map.set(key, (Map.get(key) || 0) + 1)累计 - 服务端若支持 SSE，优先让后端做聚合，前端只收
{ "200": 1234, "500": 7 }这类摘要 - 浏览器内存有限，超过 10 万条原始数据就该考虑采样或滚动窗口，而不是全量
groupBy
最容易被忽略的是：分组之后的“统计”往往不是终点，而是下一步聚合（求均值、找 Top N、判断突增）的起点——而这些操作，Object.groupBy 一个都不提供，必须自己遍历或接续其他方法。
