Firebase 8升级v9报Expected type 'Pa'自定义ba对象错误排查

根因判定 #

这个混淆短类名的报错是Firebase 9模块化SDK的内部类型校验抛出的：SDK生产构建时内部类名会被压缩为Pa/ba这类短标识，当传入的SDK内置对象（比如DocumentReference、Query）来自另一份独立的SDK实例时，哪怕对象字段、结构完全一致，内部的instanceof校验也会失败，直接抛出这类无调用栈的通用错误。
你观测到的「直接传入外部生成的DocumentReference就报错、基于传入ref的path在当前上下文重新构造ref就正常」的现象，已经可以直接确认问题本质：跨上下文传递的ref和当前执行环境的Firebase SDK不属于同一个实例。你怀疑的Yarn Workspaces monorepo多SDK实例冲突，就是这个问题的核心诱因。

排查步骤 #

• 全仓校验Firebase依赖副本：在monorepo根目录执行yarn why firebase，检查是否存在多版本Firebase SDK被重复安装的情况，重点确认自研的firestore-mobx适配库的node_modules目录下是否单独安装了一份和业务应用版本不一致的Firebase SDK。
• 排查依赖引入错误：确认web端代码路径中没有误引入Firebase Admin SDK的依赖，Admin SDK为服务端运行设计，其生成的对象实例和Web SDK做类型校验时会直接触发该错误。
• 检查依赖提升配置：如果monorepo配置了nohoist规则将Firebase排除在公共依赖提升范围外，会导致每个工作区包都持有独立的Firebase SDK副本，跨包传递ref、query等SDK内置对象时必然触发校验失败。

修复方案 #

临时绕开方案 #

不直接消费外部传入的ref对象，统一提取传入ref的path属性，用当前执行上下文持有的数据库实例重新构造安全的ref对象再调用SDK接口，参考实现：

// 避免直接使用跨实例传入的this.documentRef
const safeRef = doc(db, this.documentRef.path);
this.onSnapshotUnsubscribeFn = onSnapshot(safeRef, (snapshot) => this.handleSnapshot(snapshot), (err) => this.handleError(err));

该方案仅临时绕开实例校验，未解决多SDK副本的根本问题，长期运行可能触发其他隐式校验报错。

长期根治方案 #

• 统一全仓Firebase依赖版本：在根目录package.json中将Firebase声明为根级公共依赖，移除所有子包dependencies字段中的Firebase声明，仅在需要的子包保留TypeScript类型依赖即可，确保整个monorepo运行时仅加载一份Firebase SDK实例。
• 给工具库配置对等依赖：给firestore-mobx这类公共工具库配置peerDependencies，将Firebase声明为对等依赖，要求宿主应用提供符合版本要求的Firebase实例，避免工具库自行安装独立的Firebase副本。
• 校验构建配置：如果使用Rollup、Vite等工具构建应用或库，将Firebase配置为外部依赖，避免Firebase被重复打包进不同的bundle文件中造成多实例冲突。

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