Node.js 18 默认不支持 Object.groupBy 方法，报错 TypeError 通常是因为运行时环境版本过低。最推荐的处理方向是升级到 Node.js 20 LTS 或引入 polyfill 方案，风险边界在于升级主版本可能影响现有依赖兼容性。
先说结论：Node.js 18 原生未稳定支持该特性，需升级环境或代码兼容。
- 先确认 Node.js 版本是否低于 20
- 先处理代码兼容性（升级或 polyfill）
- 再验证业务逻辑是否正常运行
命令速用版
如果希望快速确认环境状态，可在终端执行以下命令查看当前版本：
node -v
如果版本低于 20.0.0，建议通过 nvm 切换版本或安装 polyfill 依赖：
npm install core-js
为什么会这样
根本原因是 Node.js 18 内置的 V8 引擎版本较旧，尚未默认启用 ECMAScript 2024 新特性。Object.groupBy 属于较新的 JavaScript 标准功能，需要较新的 V8 引擎支持。Node.js 20 及以上版本才提供了更完善的原生支持，而在 Node.js 18 中直接使用会导致运行时找不到该函数。
分步处理
第一步：检查当前运行时版本。执行 node -v，确认版本号是否处于 18.x 系列。
第二步：选择解决方案。如果项目允许升级，建议迁移至 Node.js 20 LTS；如果不能升级，需在项目入口文件引入 polyfill。
第三步：实施兼容代码。若使用 polyfill，可在 index.js 或全局配置文件中添加兼容逻辑，或使用 core-js 按需引入。
第四步：回滚准备。升级 Node.js 前，确保本地依赖包已测试兼容，保留原有版本配置文件以便快速回退。
怎么验证是否生效
创建一个测试脚本 test.js，写入简单的 Object.groupBy 调用逻辑。执行 node test.js，观察控制台是否输出预期分组结果且无报错。若升级了 Node.js 版本，还需运行现有单元测试套件，确认无回归错误。
常见坑
生产环境谨慎使用实验性标志。部分教程可能建议通过 `--harmony` 标志开启特性，但这属于不稳定功能，可能导致线上运行时行为不一致。依赖包兼容性需重新评估。升级 Node.js 主版本后，部分原生模块或旧版依赖可能编译失败，需在测试环境先行验证。
常见问题
能否通过 flags 强制开启支持？
不建议在生产环境使用。虽然某些 V8 标志可能启用该功能，但属于实验性特性，存在被移除或行为变更的风险。
polyfill 会影响性能吗？
会有轻微开销。polyfill 是通过 JavaScript 模拟原生行为，相比引擎原生实现会有计算损耗，但在大多数业务场景下可忽略。
Node.js 18 何时停止维护？
公开资料中没有看到可靠的量化数据。建议参考 Node.js 官方发布说明获取准确的 LTS 生命周期信息，通常 LTS 版本维护期为 30 个月左右。
参考来源
- MDN Web Docs, Object.groupBy(), https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/groupBy
- Node.js, Release notes, https://nodejs.org/