Strapi 4.25.11（Node.js v20.12.2）升级至v5时遇esbuild模块缺失问题

安全阿岳

2026-6-17

解决Strapi v5升级时的"Cannot find module esbuild"错误

清理依赖环境并重新安装
1. 删除项目下的node_modules目录和锁文件：
```
rm -rf node_modules package-lock.json yarn.lock
```
2. 清除npm缓存：
```
npm cache clean --force
```
3. 安装Strapi v5兼容的esbuild版本（推荐0.20.x系列）：
```
npm install esbuild@^0.20.0 --save-dev
```
4. 重新安装所有依赖：
```
npm install
```
强制使用项目本地依赖执行升级
避免npx调用全局环境的依赖冲突，直接用项目本地脚本执行升级：
```
./node_modules/.bin/strapi upgrade major
```
或者用npx强制不使用全局安装包：
```
npx --no-install @strapi/upgrade major
```
检查并升级npm版本
Node.js 20.12.2建议搭配npm 9.x及以上版本，执行以下命令升级npm：
```
npm install -g npm@latest
```
临时指定依赖查找路径（兜底方案）
执行升级前临时设置NODE_PATH指向项目本地依赖目录：
```
NODE_PATH=./node_modules npx @strapi/upgrade major
```