Turborepo Monorepo中React-Admin依赖问题：MUI等无法自动解析

原因分析 #

1. React-Admin的依赖规则：React-Admin v5 将 @mui/material 设为peerDependency，而非自身的直接依赖。这意味着它不会自动附带MUI，而是要求你的admin应用必须自行提供该依赖。
2. pnpm的严格隔离机制：pnpm默认不会自动安装peer依赖，在monorepo环境下，每个workspace包（比如你的apps/admin）的依赖都是独立隔离的，不会自动继承其他包的依赖。你之前在独立项目中无需手动安装，大概率是React-Admin初始化脚手架自动帮你装了peer依赖，或者你的pnpm全局配置开启了auto-install-peers=true。
3. Turborepo的workspace隔离：Turborepo默认遵循pnpm的依赖规则，每个子应用都是独立的workspace单元，不会自动共享依赖，必须显式配置才能跨包访问依赖。

解决方法 #

方法1：全局开启pnpm自动安装peer依赖（推荐）

在monorepo根目录创建或修改.pnpmrc文件，添加：

auto-install-peers=true

之后重新执行pnpm install，pnpm会自动检测并安装React-Admin所需的@mui/material，无需在admin应用的package.json里手动声明。

方法2：在admin应用中显式添加依赖

如果不想全局开启自动安装，直接在apps/admin/package.json的dependencies里加上@mui/material，版本要符合React-Admin的要求（可查看React-Admin包的peerDependencies，一般为^5.0.0以上）：

{
  "dependencies": {
    "@mui/material": "^5.14.0",
    "react-admin": "^5.5.3"
  }
}

执行pnpm install后即可正常使用MUI组件。

方法3：依赖提升到monorepo顶层（不推荐）

如果想让所有子应用共享MUI依赖，可以在根目录的.pnpmrc中配置hoisting：

hoist=true
hoist-pattern[]=@mui/*

这会把所有@mui相关依赖提升到根目录的node_modules，所有子应用都能访问。但这种方式可能引发不同子应用依赖版本冲突的问题，除非你确定所有包都用同一版本的MUI，否则不建议使用。

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