在Astro项目中安装Strapi报错求助：esbuild版本不匹配

方案1：清除缓存并指定esbuild版本创建项目 #

• 先清除npm缓存，避免残留版本干扰：
  npm cache clean --force
• 执行创建命令时直接指定兼容的esbuild版本：
  npx create-strapi-app@latest my-project --quickstart -- --esbuild=0.19.11
  或者先全局安装指定版本的esbuild，再重新创建：
  npm install -g esbuild@0.19.11
npx create-strapi-app@latest my-project --quickstart

方案2：换用yarn创建项目 #

如果本地有yarn环境，它的依赖锁机制能更好匹配Strapi所需版本：

• 先卸载全局可能存在的高版本esbuild：
  npm uninstall -g esbuild
• 用yarn执行创建命令：
  yarn create strapi-app my-project --quickstart

方案3：手动创建并锁定esbuild版本 #

• 创建项目目录并进入：
  mkdir my-project && cd my-project
• 初始化package.json：
  npm init -y
• 安装Strapi核心包：
  npm install strapi@latest
• 安装版本锁定工具：
  npm install -D npm-force-resolutions
• 在package.json中添加以下配置，强制锁定esbuild版本：

  "resolutions": {
    "esbuild": "0.19.11"
  },
  "scripts": {
    "preinstall": "npx npm-force-resolutions"
  }
  

• 重新安装依赖：
  npm install
• 启动项目：
  npx strapi develop

问题原因 #

Node.js v20虽在Strapi兼容列表内，但npx可能会调用全局已安装的高版本esbuild，导致与Strapi依赖的0.19.11版本冲突，TypeError: Cannot read properties of undefined (reading 'addBreadcrumb')是版本不匹配引发的连锁错误。

内容的提问来源于stack exchange，提问作者mohamed aziz