无法升级Storybook至8.2.4：静态文件加载失败求助

开发者阿泽

2026-6-20

Storybook 8.2.4启动报错：找不到@storybook/core/assets/browser目录

以下是针对性的排查和解决步骤：

检查@storybook/core包完整性
手动进入node_modules/@storybook/core目录，确认是否存在assets/browser文件夹。如果不存在，说明包安装不完整。同时执行yarn list @storybook/core查看安装版本是否为8.2.4，排查是否存在子依赖版本不一致的情况。
统一Storybook相关包版本
在package.json的devDependencies中明确指定所有Storybook相关包的版本为8.2.4，避免依赖解析时出现版本差异，示例：
```
"devDependencies": {
  "@storybook/react": "8.2.4",
  "@storybook/core": "8.2.4",
  "@storybook/addon-essentials": "8.2.4",
  "@storybook/manager-api": "8.2.4",
  "@storybook/preview-api": "8.2.4"
}
```
之后执行yarn install --force强制重新安装依赖，确保所有Storybook包版本统一。
检查配置文件中的路径引用
查看.storybook/main.js/ts和.storybook/preview.js/ts，确认是否存在手动引用@storybook/core/assets/browser的代码。Storybook 8.x调整了静态资源的目录结构，相关资源可能迁移到了@storybook/browser-ui等包中，比如原有的import '@storybook/core/assets/browser/globals.css'需要改为import '@storybook/browser-ui/globals.css'。
彻底清理依赖缓存
执行以下命令彻底清理后重新安装：
```
rm -rf node_modules yarn.lock
yarn cache clean
yarn install
```
排查自定义Webpack配置干扰
如果在main.js中配置了customWebpackConfig，暂时移除该配置后重新启动Storybook，确认是否是自定义配置导致静态资源路径解析错误。
新建测试项目验证
使用npx storybook@8.2.4 init创建一个全新的测试项目，安装依赖后启动。如果新项目能正常运行，说明原项目存在配置或依赖冲突，可逐步迁移配置和依赖到新项目定位问题。