升级MUI5使用mui-x-date-pickers等组件报模块找不到运行时错误

报错和tsconfig.json配置无关，TS编译通过是因为类型校验和打包时的文件路径解析逻辑独立，核心问题是MUI生态依赖版本不兼容：

• 你当前安装的@mui/x-date-pickers@^5.0.0-alpha.6是过早的alpha测试版，它引用的@mui/material内部API路径（包括unstable_composeClasses、generateUtilityClass）在@mui/material@5.8.x版本中已经调整了导出位置，旧路径被移除，直接导致模块找不到。
• 你安装的@mui/lab@^5.0.0-alpha.86内部嵌套了更低版本的@mui/x-date-pickers，没有复用根目录安装的版本，嵌套的旧依赖会重复触发路径解析错误。

1. 清理旧依赖和锁文件，避免残留缓存干扰：
   • npm用户执行：

     rm -rf node_modules package-lock.json
     

   • yarn用户执行：

     rm -rf node_modules yarn.lock
     

   • pnpm用户执行：

     rm -rf node_modules pnpm-lock.yaml
     

2. 替换package.json中MUI相关依赖为兼容版本组合，不要使用过老的alpha预发布版：

   "@mui/icons-material": "^5.8.4",
   "@mui/lab": "5.0.0-alpha.88",
   "@mui/material": "^5.8.6",
   "@mui/styles": "^5.8.6",
   "@mui/utils": "^5.8.6",
   "@mui/x-data-grid": "^5.12.3",
   "@mui/x-date-pickers": "^5.0.0-beta.0",
   

   注：@mui/x-date-pickers从5.0.0-beta.0版本开始才适配了@mui/material@5.8+的内部导出路径调整
3. 重新执行依赖安装命令即可。
4. 如果安装后仍存在嵌套依赖版本不一致的问题，添加包版本强制解析规则：
   • npm用户在package.json中添加overrides字段：

     "overrides": {
       "@mui/x-date-pickers": "^5.0.0-beta.0",
       "@mui/material": "^5.8.6",
       "@mui/utils": "^5.8.6"
     }
     

   • yarn用户在package.json中添加resolutions字段，配置内容和上面的overrides完全一致，配置后重新执行依赖安装即可。

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