新建React项目执行npm run storybook报错找不到react-refresh模块如何解决
2026-10-1
问题根因
该报错由@storybook/preset-create-react-app版本与Storybook核心版本不兼容导致：@storybook/preset-create-react-app@4.x仅支持Storybook 6.4及以上版本，你当前使用的Storybook 6.3.9与v4版preset不匹配，会导致依赖引入的react-refresh包安装不完整，出现package.json声明的main入口文件实际缺失的问题。
解决方案
可选择以下任意一种方案执行：
方案1：降级preset适配现有Storybook版本（操作成本最低）
- 卸载当前高版本preset：
npm uninstall @storybook/preset-create-react-app - 安装兼容6.3.x版本的preset：
npm install @storybook/preset-create-react-app@3.2.0 --save-dev - 删除项目根目录下的
node_modules文件夹、package-lock.json文件 - 重新安装依赖：
npm install - 启动Storybook验证：
npm run storybook
方案2：升级Storybook适配高版本preset
- 执行官方升级命令一键升级Storybook到最新兼容版本：
npx sb upgrade - 重新安装依赖后启动即可
临时应急方案
如果不需要调整版本，直接手动安装完整的react-refresh包覆盖残缺的子依赖即可：
- 执行安装命令：
npm install react-refresh --save-dev - 重启Storybook即可正常运行
内容的提问来源于stack exchange，提问作者TheBritishAreComing
相关产品推荐
相关产品推荐
