Windows环境下Strapi依赖安装失败问题求助
2026-6-20
Strapi创建项目时esbuild版本不匹配+权限错误的解决办法
问题原因
- esbuild版本冲突：Strapi依赖锁定了特定版本的esbuild（0.19.11），但包管理器安装时可能因全局缓存、嵌套依赖优先级或版本解析逻辑，拉取了更高版本（0.21.5），导致版本不兼容。
- 目录权限/占用问题：EBUSY、ENOTEMPTY、EPERM错误说明目标目录或临时文件被系统进程占用，或当前用户无足够权限修改目录——Windows系统下这类问题更常见，比如杀毒软件、资源管理器锁定了文件夹。
解决步骤
一、彻底清理缓存与残留文件
- 删除全局npm缓存：
npm cache clean --force - 手动删除已创建的
backend-strapi目录，确保无进程占用该文件夹（Windows可关闭相关Node进程，或重启电脑后删除） - 若用yarn，清理yarn缓存：
yarn cache clean
二、强制锁定esbuild版本安装
创建项目时直接指定esbuild版本，避免冲突：
npx create-strapi-app backend-strapi --quickstart --package-manager npm --env esbuild@0.19.11
或手动指定版本：
- 创建项目但不自动安装依赖：
npx create-strapi-app backend-strapi --quickstart --no-install - 进入目录：
cd backend-strapi - 在
package.json的dependencies中添加"esbuild": "0.19.11" - 安装依赖：
npm install
三、解决权限与目录占用问题
- Windows系统：
- 关闭所有打开的资源管理器窗口，确保
backend-strapi目录未被预览或占用 - 右键以管理员身份运行终端，再执行创建命令
- 临时关闭杀毒软件或防火墙，避免其锁定安装目录
- 关闭所有打开的资源管理器窗口，确保
- Linux/macOS系统：
- 赋予当前用户目录读写权限：
sudo chown -R $USER:$USER ./ - 检查并终止占用目录的进程：
lsof | grep backend-strapi，找到进程后用kill [进程ID]终止
- 赋予当前用户目录读写权限：
四、切换到兼容的Node.js版本
Strapi v4.x推荐使用Node 18.x或20.x LTS版本，不建议用已停止维护的Node 14，或兼容性未验证的Node 22：
- 用nvm切换版本：
nvm install 18 && nvm use 18 - 确认npm版本在8.x或9.x区间：
npm -v
内容的提问来源于stack exchange，提问作者Jezyk
相关产品推荐
相关产品推荐
