You need to enable JavaScript to run this app. 如何解决create-next-app执行时jest-worker@27.0.0-next.5的Node引擎不兼容错误
优惠活动
大模型
产品
解决方案
定价
更多

如何解决create-next-app执行时jest-worker@27.0.0-next.5的Node引擎不兼容错误

Next.js 项目创建时 Node 引擎不兼容报错的解决方法

报错核心:当前 Node 14.5.0 未达到 jest-worker@27.0.0-next.5 要求的版本范围(^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0),Yarn 触发拦截导致安装中止。可根据自身场景选择以下方案:

  • 方案1:升级 Node 到合规版本(最稳定推荐)
    将 Node 升级到 14.15.0 及以上的 14.x 版本,或 16/18/20 等更高的长期支持版本,升级完成后重新执行 npx create-next-app hellochat 即可正常完成依赖安装。
  • 方案2:临时绕过 Yarn 引擎校验(应急用)
    若暂时无法升级 Node,可通过配置跳过 Yarn 的版本拦截:
    • 执行命令关闭 Yarn 引擎检查:yarn config set ignore-engines true
    • 重新执行 npx create-next-app hellochat 走完创建流程
    • 项目创建完成后可恢复默认校验规则:yarn config delete ignore-engines
      注意:该操作仅跳过安装阶段的报错拦截,若依赖和低版本 Node 存在运行时不兼容,后续启动项目仍可能出现异常。
  • 方案3:指定适配低版本 Node 的 create-next-app 版本
    如需在 Node 14.5.0 环境下稳定运行项目,可直接拉取适配该环境的旧版脚手架创建项目,避免引入过高版本依赖:
    执行命令:npx create-next-app@10 hellochat,该版本适配 Node 14.x 早期版本,不会拉取触发当前报错的高版本 jest-worker 依赖。

内容的提问来源于stack exchange,提问作者Arbab Ali

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 21:15:02