使用FieldValue或FirestoreAdminClient时出现undefined错误

问题原因 #

你遇到的TypeError: Cannot read properties of undefined (reading 'FirestoreAdminClient')，是因为Firebase Admin SDK的版本或API路径使用错误——新版本的SDK已经不再通过admin.firestore.v1.FirestoreAdminClient这种嵌套路径暴露Admin客户端，旧版本也没有这个属性。

解决方案 #

1. 升级到最新版Firebase Admin SDK
   先确保你的依赖是最新稳定版，执行命令：

npm install firebase-admin@latest

2. 调整FirestoreAdminClient的获取方式
   不要通过admin.firestore.v1访问，而是直接从firebase-admin/firestore导出：

// CommonJS 写法
const admin = require('firebase-admin');
const { FirestoreAdminClient } = require('firebase-admin/firestore');

// 必须先初始化Admin SDK
admin.initializeApp({
  // 填入你的项目配置，比如 serviceAccount 路径等
});

// 创建Admin客户端实例
const client = new FirestoreAdminClient();

如果是ES模块（import语法）：

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

admin.initializeApp({ /* 配置 */ });
const client = new FirestoreAdminClient();

3. FieldValue的使用无需修改
   你代码里的admin.firestore.FieldValue.increment(1)是正确的，只要Admin SDK初始化正常，这部分可以继续保留使用。

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