Vite项目构建报错：Rollup无法解析react-redux导入

构建小型Vite项目时出现如下报错，尝试用require替代import导入react-redux模块后问题仍未解决：

This is most likely unintended because it can break your application at runtime.
If you do want to externalize this module explicitly add it to
`build.rollupOptions.external`
error during build:
Error: [vite]: Rollup failed to resolve import "react-redux" from "C:/Users/user/OneDrive/Documents/react course work/fast-react-pizza/src/main.jsx".
This is most likely unintended because it can break your application at runtime.
If you do want to externalize this module explicitly add it to
`build.rollupOptions.external`
    at viteWarn (file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/vite/dist/node/chunks/dep-df561101.js:48142:27)
    at onwarn (file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/@vitejs/plugin-react/dist/index.mjs:238:9)
    at onRollupWarning (file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/vite/dist/node/chunks/dep-df561101.js:48171:9)
    at onwarn (file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/vite/dist/node/chunks/dep-df561101.js:47902:13)
    at file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/rollup/dist/es/shared/node-entry.js:24152:13)
    at Object.logger [as onLog] (file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/rollup/dist/es/shared/node-entry.js:25825:9)
    at ModuleLoader.handleInvalidResolvedId (file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/rollup/dist/es/shared/node-entry.js:24738:26)
    at file:///C:/Users/user/OneDrive/Documents/react%20course%20work/fast-react-pizza/node_modules/rollup/dist/es/shared/node-entry.js:24698:26)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)

问题原因 #

1. 未安装或依赖损坏：react-redux未被正确安装到项目中，或者node_modules依赖包损坏。
2. 错误的外部化配置：Vite的build.rollupOptions.external中误将react-redux列为外部模块，导致Rollup不打包该模块但运行时无法找到。
3. CommonJS兼容问题：Vite默认优先处理ES模块，直接用require无法解决核心依赖缺失问题，反而可能引入模块格式不兼容的问题。

解决方案 #

1. 重新安装react-redux依赖 #

打开项目根目录终端，执行以下命令：

# 安装react-redux
npm install react-redux
# 或 yarn add react-redux
# 或 pnpm add react-redux

如果之前已安装但仍报错，建议清理依赖后重新安装：

# 删除node_modules和锁文件
rm -rf node_modules package-lock.json
# 重新安装所有依赖
npm install

2. 检查并修正Vite外部化配置 #

打开vite.config.js/vite.config.ts，查看build.rollupOptions.external配置，若包含react-redux则移除：

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      external: [
        // 移除'react-redux'条目
      ]
    }
  }
})

3. 规范使用ES模块导入（可选） #

Vite推荐使用ES模块的import语法，避免混用require。若确实需要处理CommonJS模块，可安装@vitejs/plugin-commonjs插件兼容：

npm install @vitejs/plugin-commonjs --save-dev

然后在Vite配置中启用插件：

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import commonjs from '@vitejs/plugin-commonjs'

export default defineConfig({
  plugins: [react(), commonjs()]
})

内容的提问来源于stack exchange，提问作者Z41_1N