Cloud Functions中Firestore Query类型的TypeScript导入路径问询

嘿，我帮你理清楚这个问题！在Cloud Functions环境下，你不需要依赖客户端的firebase包或者废弃的@firebase/firestore-types，正确的做法是直接从firebase-admin的firestore子模块导入Query类型。

正确的导入方式 #

你可以直接这样写：

import { Query } from 'firebase-admin/firestore';

如果需要同时使用Firestore实例和类型，也可以这样组合导入：

import * as admin from 'firebase-admin';
import { Query } from 'firebase-admin/firestore';

// 初始化Admin SDK（如果还没做的话）
admin.initializeApp();

// 示例：定义一个接收Query参数的函数
async function handleQuery(query: Query) {
  const snapshot = await query.get();
  snapshot.forEach(doc => {
    console.log(`文档ID: ${doc.id}, 数据: ${JSON.stringify(doc.data())}`);
  });
}

// 使用示例：创建一个Query并传入函数
const userQuery = admin.firestore().collection('users').where('status', '==', 'active');
await handleQuery(userQuery);

为什么之前的方法不行？ #

• firebase-admin旧版本类型结构不同：如果你的firebase-admin版本比较老，可能没有把类型单独拆分到子模块里，建议执行npm install firebase-admin@latest更新到最新版本。
• @firebase/firestore-types已被官方废弃：这个包的类型维护已经停止，官方明确推荐直接使用对应SDK自带的类型。
• 客户端firebase包不适合Cloud Functions：这个包是为Web/移动端客户端设计的，Cloud Functions属于服务端环境，必须使用firebase-admin SDK才能获得完整的服务端权限和正确的类型支持。

如果更新后还是找不到类型，可以检查下你的tsconfig.json是否将moduleResolution配置为node（这是Node.js环境的默认配置，一般不需要额外修改）。

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