构建失败：@material-ui/data-grid与React版本依赖冲突求助

问题根源 #

当前项目依赖的@material-ui/data-grid@4.0.0-alpha.37强制要求React版本为^17.0.0，但项目实际安装的React版本是16.13.0，导致peer依赖解析失败。其他依赖（如@material-ui/core）虽兼容React 16或17，但data-grid的严格版本限制引发了冲突。

解决方案 #

方案1：升级React到17.x版本（推荐）

这是最彻底的修复方式，多数现有依赖已支持React 17，不会破坏原有功能：

npm install react@^17.0.0 react-dom@^17.0.0

安装完成后重新执行构建命令即可。

方案2：使用--legacy-peer-deps参数跳过冲突检查

若暂时无法升级React，可通过npm参数强制解析依赖（注意：此方式可能忽略潜在兼容性风险）：

npm install --legacy-peer-deps

方案3：降级@material-ui/data-grid至兼容React 16的版本

查找支持React 16的@material-ui/data-grid早期alpha版本，修改package.json中的版本号后重新安装：

{
  "@material-ui/data-grid": "^4.0.0-alpha.30"
}

执行安装：

npm install

方案4：迁移至MUI X Data Grid（长期维护建议）

@material-ui/data-grid已迁移至@mui/x-data-grid，后续更新会集中在该包。若项目允许，可替换依赖：

npm uninstall @material-ui/data-grid
npm install @mui/x-data-grid

需同步调整代码中的导入路径（如import { DataGrid } from '@mui/x-data-grid'）。

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