NextJS 15.0项目中React与Firebase的依赖冲突求助

针对@react-google-maps/api与React 19 RC的冲突 #

如果不想降级React，可通过npm的overrides强制忽略peer依赖检查：

1. 打开项目根目录的package.json，添加以下配置：

"overrides": {
  "@react-google-maps/api": {
    "react": "^19.0.0-rc",
    "react-dom": "^19.0.0-rc"
  }
}

2. 删除node_modules和package-lock.json，重新执行npm install
3. 验证本地运行是否正常，若无 runtime 错误即可继续

若担心React 19 RC的兼容性问题，直接降级React到18.2.0：

• 修改package.json中react和react-dom的版本为"^18.2.0"，执行npm install

解决--legacy-peer-deps安装后部署仍冲突的问题 #

--legacy-peer-deps是本地安装时的临时选项，部署环节（如firebase deploy）不会继承这个配置，必须用overrides固化依赖规则：

• 按上述方法在package.json中添加对应依赖的overrides配置，确保部署时npm自动忽略peer版本不匹配的问题

处理firebase-frameworks与Firebase 11.0.1的冲突 #

方案1：降级Firebase到10.x版本 #

修改package.json中firebase的版本为"^10.12.0"（最新稳定10.x版本），执行npm install，再重新部署

方案2：强制firebase-frameworks兼容Firebase 11 #

在package.json中添加overrides：

"overrides": {
  "firebase-frameworks": {
    "firebase": "^11.0.1"
  }
}

删除依赖缓存后重新安装，部署前先本地运行验证是否有兼容性报错

综合稳定方案（推荐） #

如果希望避免后续冲突，优先选择稳定版本组合：

1. 锁定React版本为18.2.0，Firebase版本为10.12.0
2. 在package.json中添加overrides确保@react-google-maps/api适配React 18：

"overrides": {
  "@react-google-maps/api": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
}

3. 执行npm install，本地测试通过后再执行firebase deploy

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