Firebase v9迁移报错：导入NPM组件后collection()首参数类型无效求助

你遇到的报错本质是组件库和主项目加载了两份独立的Firebase实例，导致类型校验失败：

• 组件库的Storybook运行在组件库项目内，全程使用同一份Firebase依赖，所以运行正常
• 发布到NPM后，组件库如果内置了Firebase依赖，主项目安装时会生成两份Firebase代码，你从主项目传入的Firestore实例是主项目依赖生成的，组件库内部的collection()/doc()方法是组件库自带的Firebase导出的，两者内部的构造函数判断逻辑不识别对方生成的实例，所以抛出参数类型错误。你在控制台打印的实例看起来结构正常，是因为两个版本的Firestore实例属性结构一致，但原型链来自不同的构造函数，内部校验时无法通过类型判断。

按优先级从高到低尝试：

• 调整组件库依赖配置：打开组件库的package.json，将所有Firebase相关依赖从dependencies字段移动到peerDependencies字段，指定兼容版本范围，示例：

{
  "peerDependencies": {
    "firebase": "^9.0.0",
    "react": "^17.0.0 || ^18.0.0"
  }
}

该配置会要求主项目自行安装Firebase，组件库直接复用主项目的依赖，避免重复加载。

• 调整组件库打包配置：在Rollup/Vite/Webpack等打包工具的配置中，将Firebase相关包标记为外置（external），不要打包进组件库产物。以Rollup为例：

// rollup.config.js
export default {
  // 其他配置
  external: ['firebase/app', 'firebase/firestore', 'firebase/auth', 'firebase/functions']
}

• 清理主项目依赖缓存：修改组件库配置重新发布后，删除主项目的node_modules、package-lock.json/yarn.lock/pnpm-lock.yaml文件，重新执行安装命令，之后运行npm ls firebase验证，确保只有一个版本的Firebase被安装。
• 若使用Monorepo架构，额外检查包管理工具的依赖提升配置，确保Firebase被提升到根目录的node_modules，不会在子包中重复安装。

你提到的「传递配置到组件库内部初始化」可以快速验证上述判断，若该方案运行正常即可确认是依赖重复问题，不建议长期使用该方案，会导致主项目和组件库各初始化一份Firebase实例，引发其他未知问题。

内容的提问来源于stack exchange，提问作者Glenn Arnold Barosen