如何解决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 存在运行时不兼容,后续启动项目仍可能出现异常。
- 执行命令关闭 Yarn 引擎检查:
- 方案3:指定适配低版本 Node 的 create-next-app 版本
如需在 Node 14.5.0 环境下稳定运行项目,可直接拉取适配该环境的旧版脚手架创建项目,避免引入过高版本依赖:
执行命令:npx create-next-app@10 hellochat,该版本适配 Node 14.x 早期版本,不会拉取触发当前报错的高版本jest-worker依赖。
内容的提问来源于stack exchange,提问作者Arbab Ali
相关产品推荐
相关产品推荐

