react@17.0.2与@apollo/react-common@3.1.4依赖冲突报错如何解决

报错的核心是项目里混装了新旧两套Apollo React生态依赖，版本兼容规则完全冲突：

• 你手动安装的@apollo/react-common@3.1.4属于Apollo早期拆分发布的旧包，它的peer依赖明确要求react@^16.8.0，不支持React17，这是触发ERESOLVE错误的直接原因。
• 你项目里已经安装的@apollo/client@3.6.8是Apollo Client 3.x的正式版本，从3.0版本发布开始，官方就已经把之前拆分出去的@apollo/react-hooks、@apollo/react-components、@apollo/react-common、react-apollo所有React相关能力全部内置到@apollo/client单包里了，额外单独安装这些早已废弃的旧拆分包，只会拉取不兼容的旧依赖树触发冲突。

你加--legacy-peer-deps参数没生效也很正常：你是在package.json里显式声明了要安装3.1.4版本的@apollo/react-common，npm解析根依赖的peer规则时不会跳过这个校验，不是参数失效，是你声明安装的包本身版本就和现有React版本不兼容。

• 卸载所有冗余的废弃Apollo旧包，需要删除的依赖包括@apollo/react-common、@apollo/react-components、@apollo/react-hooks、react-apollo，直接执行卸载命令：

npm uninstall @apollo/react-common @apollo/react-components @apollo/react-hooks react-apollo

• 调整代码里的导入路径，所有之前从旧拆分包引入的API，全部统一从@apollo/client导入即可，对应示例：

// 废弃的旧导入写法 直接删掉
// import { useQuery } from '@apollo/react-hooks'
// import { Query } from '@apollo/react-components'

// 新的统一导入写法
import { useQuery, Query, ApolloProvider } from '@apollo/client'

• 清理旧依赖缓存和锁文件后重新安装：

# 删除旧的依赖目录和锁文件
rm -rf node_modules package-lock.json
# 重新执行依赖安装
npm install

• 不要用--force或者--legacy-peer-deps参数强行绕过冲突，就算勉强安装成功，运行时大概率会出现React多实例冲突、Hooks调用报错、Apollo上下文不匹配的问题，旧版@apollo/react-common本身就是针对React16开发的，和React17的调度、上下文逻辑存在兼容差异。
• 不要为了适配旧包把React版本降回16.x，那些拆分的@apollo/react-*包官方早已停止维护，所有bug修复、新特性迭代都只在@apollo/client主包中跟进，降级React只会带来更多额外的兼容问题。

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