安装react-to-pdf包时遭遇ERESOLVE依赖树解析错误求助

AI 小北

2026-4-22

嘿，我最近在给我的项目安装react-to-pdf包时碰了壁，执行npm install react-to-pdf命令后，直接抛出了ERESOLVE依赖树解析错误，完整的错误日志如下：

npm ERR! code ERESOLVE

npm ERR! ERESOLVE unable to resolve dependency tree

npm ERR!

npm ERR! While resolving: my-portfolio-app@0.0.0

npm ERR! Found: react@18.2.0

npm ERR! node_modules/react

npm ERR!   react@"^18.2.0" from the root project

npm ERR!

npm ERR! Could not resolve dependency:

npm ERR! peer react@"^16.5.2" from react-to-pdf@0.0.14

npm ERR! node_modules/react-to-pdf

npm ERR!   react-to-pdf@"*" from the root project

npm ERR!

npm ERR! Fix the upstream dependency conflict, or retry

npm ERR! this command with --force or --legacy-peer-deps

npm ERR! to accept an incorrect (and potentially broken) dependency resolution.

npm ERR!

npm ERR!

npm ERR! For a full report see:

npm ERR! C:\Users\ga\AppData\Local\npm-cache\_logs\2023-07-10T14_01_46_021Z-eresolve-report.txt

npm ERR! A complete log of this run can be found in: C:\Users\ga\AppData\Local\npm-cache\_logs\2023-07-10T14_01_46_021Z-debug-0.log

PS F:\PaperClip\my-Portfolio-app>

我看了错误提示，大概明白是React版本不兼容的问题——我的项目用的是React 18.2.0，但react-to-pdf@0.0.14要求的peer依赖是React ^16.5.2。有没有大佬能给我讲讲怎么解决这个问题呀？

可能的解决方案（整理自社区经验）

使用--legacy-peer-deps参数安装：这个参数会让npm采用旧版本的依赖解析逻辑，忽略peer依赖的版本冲突，是比较稳妥的方式，执行命令：
```
npm install react-to-pdf --legacy-peer-deps
```
使用--force参数强制安装：这个命令会强制npm跳过依赖冲突检查直接安装，但可能会带来潜在的兼容性问题，建议谨慎使用：
```
npm install react-to-pdf --force
```
检查并安装适配React 18的新版本：可以先确认react-to-pdf是否有更新版本支持React 18，如果有的话，直接安装最新版：
```
npm install react-to-pdf@latest
```