You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

安装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版本管理,依次执行以下命令即可:
    1. 安装Node 16版本:nvm install 16
    2. 切换当前终端环境到Node 16:nvm use 16
    3. (可选)将Node 16设为全局默认版本,避免新开终端自动切回高版本:nvm alias default 16
      切换完成后执行node -v确认输出的版本号在12.x~16.x区间内,重新执行Strapi安装命令即可正常安装。
  • 方案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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.31 10:15:37