最近开发了一个React拖拽排序组件库，计划通过npm link到本地测试时，遇到了报错：Warning: Invalid hook call. Hooks can only be called inside of the body of a function component.经过多轮排查，最终发现到React多实例冲突与pnpm对peerDependencies的隐式安装是核心原因，以下是完整解决流程，供同类问题参考

一、问题初判：React版本兼容性？

测试项目使用Next 15（App Router）报错，初步怀疑版本冲突：

• Next 15 App Router默认依赖React 19，但组件库用了React 18.3.1
• 尝试放宽版本限制：将组件库package.json中react的版本范围改为"^18.3.1 || ^19.0.0"，但测试仍报错
• 结论：版本兼容性非主因（组件库并没有使用与react18强相关的特性）

二、排查方向：组件库依赖配置问题

查阅React官方文档（Invalid Hook Call警告）和关键Issue（https://github.com/facebook/react/issues/13991），提示可能是**React多实例**或**Hooks未在函数组件内调用**导致。因为组件代码没有问题所以排除后者，重点排查多实例：

1. 验证多实例的关键方法

• 现象辅助判断：同时出现**Invalid hook call和Cannot read properties of null (reading 'useState')**，是典型多实例特征（不同React实例的Hooks上下文不共享）
• 打包产物检查：
  • 构建后搜索组件库代码，确认仅在入口有import React from 'react'，其他位置无重复引入或者明显的function useState(){}定义等
  • 使用rollup-plugin-visualizer分析打包依赖，确认React未被打包进组件库

2. 修复尝试：配置peerDependencies与外部化

• peerDependencies声明：在组件库package.json中，将react和react-dom标记为peerDependencies（告知用户需自行安装）
• Rollup外部化配置：在vite.config.ts中，通过build.rollupOptions.external将React相关模块排除在打包外：["react", "react-dom", "react/jsx-runtime"] 关键：包括react/jsx-runtime
• 结果：仍报错

三、关键突破：React路径指向异常

尝试暴力验证：将组件库打包后的import React from 'react'改为测试项目中React的绝对路径（如import React from '/path/to/test-project/node_modules/react'），测试项目运行正常

• 结论：实锤组件库与测试项目引用了不同路径的React实例

四、终极原因：pnpm对peerDependencies的隐式安装

进一步排查依赖管理工具pnpm的特性：