安装Strapi执行npx create-strapi-app提示Node版本不兼容如何解决
Strapi安装时Node引擎不兼容报错修复
报错信息
执行npx create-strapi-app安装Strapi时抛出以下错误:
The engine "node" is incompatible with this module. Expected version ">=12.x.x <=16.x.x". Got "18.3.0"
error Found incompatible module.
报错原因
你当前使用的Strapi安装包兼容的Node.js版本范围为12.x~16.x,本地环境安装的Node.js版本为18.3.0,不满足依赖的版本要求,触发了依赖校验拦截。
可行修复方案
按推荐优先级从高到低排列:
- 方案1:切换Node.js版本到兼容区间(最稳妥,无后续兼容隐患)
推荐安装Node.js 16.x LTS长期支持版本,如果你用nvm做Node版本管理,依次执行以下命令即可:- 安装Node 16版本:
nvm install 16 - 切换当前终端环境到Node 16:
nvm use 16 - (可选)将Node 16设为全局默认版本,避免新开终端自动切回高版本:
nvm alias default 16
切换完成后执行node -v确认输出的版本号在12.x~16.x区间内,重新执行Strapi安装命令即可正常安装。
- 安装Node 16版本:
- 方案2:安装适配Node 18的高版本Strapi
Strapi v4.3.2及以上版本已原生支持Node.js 18,你可以直接拉取最新版Strapi安装包,不需要降级本地Node版本,执行命令:npx create-strapi-app@latest 你的项目名 - 方案3:临时跳过引擎版本校验(不推荐,仅适合临时测试场景)
如果暂时不想调整Node版本、也不需要保证运行稳定性,可以在安装时加参数跳过版本校验,强制执行安装:npx create-strapi-app 你的项目名 --ignore-engines
注意:该方式绕过了依赖的版本校验逻辑,后续Strapi启动、运行过程中大概率会出现未知的兼容报错,生产环境不要使用这个方案。
内容的提问来源于stack exchange,提问作者JinJin
相关产品推荐
相关产品推荐

