React跨包共享Provider时,第三方Hook获取上下文返回undefined
问题根因:依赖多副本导致的Context引用不匹配
你遇到的所有现象都可以被这一个原因完全解释:
- core包内部用对应Hook能正常拿到Context值,子项目直接从第三方包导入Hook就拿不到
- 从core包重导出第三方Hook给子项目使用,就能正常获取值
- 哪怕package.json里写的第三方依赖版本完全一致,只要node_modules里存在两份独立的包副本,就会触发问题
- 升级React 17、CRA 4之后才出现,和版本迭代的行为变化直接相关
核心原理
React Context的匹配逻辑是严格对象引用相等:
每一次引入同一个第三方包的代码,只要来自两份独立安装的包副本,拿到的Context对象就是两个完全不同的引用。
你的ProjAppProvider是core包内部的代码,它用的ThemeProvider来自core包依赖的那份@material-ui/core,对应的Context是A对象;子项目里直接从顶层node_modules导入的useTheme,来自另一份独立安装的@material-ui/core,对应的Context是B对象。A和B根本不是同一个对象,自然读不到Provider注入的主题值,只能返回组件内置的兜底默认值。
notistack没有内置的兜底默认值,所以直接返回undefined。
这也能解释你观察到的makeStyles异常:
只要makeStyles是从顶层node_modules那份@material-ui/core导入的,它绑定的就是B对象Context,和Provider用的A对象不匹配,自然会忽略传入的主题值,走默认主题的逻辑。
而当你从core包导出Hook/工具函数给子项目用的时候,这些函数绑定的是core包那份的A对象Context,和Provider的引用完全匹配,所以能正常工作。
为什么升级React17/CRA4后会触发
- React 16时代如果检测到存在两份React副本,会直接抛出明确的错误提示;React 17开始移除了这个强制校验,副本存在时不会有任何报错,只会静默出现Context不匹配的诡异问题
- CRA4默认升级到webpack 5,不管是本地link公共包、还是monorepo场景下的依赖解析,都更容易因为路径解析规则变化,把core包的依赖安装到嵌套的
node_modules路径下,形成独立的副本
验证方法
直接在子项目根目录运行对应包管理器的依赖列表命令,检查是否存在多路径安装:
- npm项目:
npm ls react @material-ui/core notistack - yarn项目:
yarn list react @material-ui/core notistack
只要输出里同一个包出现2个及以上的安装路径,就可以100%确认是副本问题。
落地解决方案
按照优先级从高到低排序:
- 第一优先级:强制消除重复依赖副本
- npm项目:在项目根目录添加
.npmrc文件,写入prefer-same-version=true,删除node_modules和package-lock.json后重新安装 - yarn1项目:在
package.json中添加resolutions字段,把react、react-dom、@material-ui/core、notistack这些公共依赖强制指定为统一版本,重新安装 - pnpm项目:在
pnpm-workspace.yaml中通过public-hoist-pattern把这些公共依赖提升到顶层,避免嵌套安装形成副本
- npm项目:在项目根目录添加
- 第二优先级:打包公共包时标记外部依赖
打包project-core的时候,不要把react、@material-ui/core、notistack这些运行时依赖打进产物,在rollup/webpack的配置里把这些依赖标记为external,让core包运行时直接复用子项目安装的依赖副本,从根源上避免两份独立包的问题。这也是做公共组件/组件库的标准操作,能完全规避用户侧版本不匹配的副本问题。 - 临时过渡方案(不推荐长期使用)
就是你当前验证有效的方式:从core包统一重导出所有第三方提供的Hook、工具函数(比如useTheme、makeStyles、useSnackbar),让子项目统一从core包导入这些能力,保证和Provider使用的是同一个Context引用。这个方案的问题是耦合度高,维护成本大,只要漏导出一个方法就会触发同类问题,只适合应急。
内容的提问来源于stack exchange,提问作者CrustyRatFink
相关产品推荐
相关产品推荐

