使用firebase-admin对接Firestore时缺失@opentelemetry/api模块报错求助

架构老林

2026-6-15

解决Firebase Admin对接Firestore时无法找到@opentelemetry/api的问题

以下是几个经过验证的解决方案，按顺序尝试：

清理依赖缓存并重装
依赖缓存或锁文件损坏可能导致依赖安装不完整，执行以下命令：
```
rm -rf node_modules package-lock.json
npm install
```
若使用Yarn，替换为：
```
rm -rf node_modules yarn.lock
yarn install
```
指定兼容版本安装
部分Firebase Admin版本与最新版@opentelemetry/api存在兼容性问题，尝试安装已知兼容的版本组合：
```
npm uninstall firebase-admin @opentelemetry/api
npm install firebase-admin@11.11.0 @opentelemetry/api@1.4.1
```
（注：版本号可根据Firebase Admin官方release notes调整，确保二者依赖匹配）

核对Firestore初始化代码
避免直接导入firebase-admin/firestore，正确的初始化方式应为：

const admin = require('firebase-admin');
const serviceAccount = require('./your-service-account.json');

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount)
});

const db = admin.firestore();