Windows 11下React+Webpack版Storybook启动EBUSY报错求助
解决Windows 11上Storybook启动的EBUSY资源占用错误
针对你遇到的Windows 11上Storybook启动时出现的EBUSY资源锁定错误,以下是几个可行的解决/规避方案:
1. 自定义Storybook缓存目录
默认缓存目录位于node_modules/.cache,可能因Windows权限或Defender扫描导致文件锁定。手动指定缓存到项目内的独立目录:
- 修改
package.json中的storybook脚本:"scripts": { "storybook": "storybook dev -p 6006 --cache-dir .storybook/cache" } - 手动创建
.storybook/cache文件夹,确保当前用户拥有读写权限。
2. 排除缓存目录于Windows Defender扫描
Windows Defender实时保护可能会锁定缓存文件,导致EBUSY错误:
- 打开Windows安全中心 → 病毒和威胁防护 → 管理设置 → 添加或删除排除项
- 将
.storybook/cache(或自定义的缓存目录)添加到排除列表中
3. 调整SWC编译器版本
你使用的@storybook/addon-webpack5-compiler-swc@3.0.0可能与Windows 11存在兼容性问题:
- 尝试降级到2.x版本:
npm uninstall @storybook/addon-webpack5-compiler-swc npm install @storybook/addon-webpack5-compiler-swc@^2.0.0 - 若降级无效,可暂时移除该插件,改用默认Babel编译测试。
4. 切换到Node.js LTS版本
部分Node.js版本在Windows 11的文件系统操作上存在兼容性问题,建议切换到Node.js 20.x LTS版本,重新安装依赖后启动Storybook。
5. 彻底清理依赖与缓存
执行以下操作强制清理所有缓存并重新安装依赖:
# Windows命令 rd /s /q node_modules .cache .storybook\cache del package-lock.json npm install
内容的提问来源于stack exchange,提问作者Shyam Patil
相关产品推荐
相关产品推荐

