Cloudflare Pages部署React项目依赖冲突问题解决咨询

1. 修复react-bubble-ui与React 18的依赖冲突 #

以下是几种可行的解决办法：

• 使用npm overrides强制兼容：在项目根目录的package.json中添加overrides字段，强制让react-bubble-ui适配当前React版本：

  "overrides": {
    "react-bubble-ui": {
      "react": "^18.3.1",
      "react-dom": "^18.3.1"
    }
  }
  

  保存后重新执行npm install，推送代码到仓库后，Cloudflare Pages构建时会遵循这个覆盖规则，跳过peer版本不匹配的报错。
• 改用legacy peer依赖模式构建：把Cloudflare Pages的构建命令修改为：

  npm install --legacy-peer-deps && npm run build
  

  本地能正常构建大概率是因为npm默认启用了legacy模式，这个命令会让Cloudflare在安装依赖时忽略peer版本冲突，和本地环境保持一致。
• fork并修改依赖要求：如果上述方法存在兼容性隐患，可以fork react-bubble-ui的仓库，修改其package.json中的peer依赖为react@^16.0.0 || ^18.0.0，然后将项目内的依赖指向你fork后的仓库地址（比如"react-bubble-ui": "github:your-username/react-bubble-ui"），重新安装依赖即可。

2. 可以直接部署本地生成的build文件 #

完全可行，这是绕开云端构建冲突的快速方案：

• 本地执行npm run build生成build文件夹；
• 登录Cloudflare Pages控制台，创建新项目时选择「上传资产」选项；
• 将build文件夹内的所有文件（注意是文件夹里的内容，而非整个build文件夹）拖入上传区域，完成后即可部署。

此方法跳过了云端的依赖安装和构建流程，直接使用本地已验证可用的静态资源。

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