Firebase Cloud Functions无法使用serverTimestamp问题求助

问题原因 #

出现该错误的核心原因是admin.firestore.FieldValue未被正确识别，通常和以下两种情况有关：

• Firebase Admin SDK未完成初始化
• 版本更新后FieldValue的访问方式存在兼容问题

解决方案 #

方案1：显式初始化Firebase Admin SDK #

在Cloud Functions中，虽部分场景会自动初始化Admin SDK，但显式初始化能规避版本升级带来的兼容问题。修改代码，在导入admin后添加初始化语句：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";

// 显式初始化Admin SDK
admin.initializeApp();

const endpoint = functions.region("asia-northeast1");
export const test = endpoint.https.onCall(async (req) => {
  const original = req.hotelCode;
  const writeResult = await admin
      .firestore()
      .collection("messages")
      .add({
        original: original,
        created_at: admin.firestore.FieldValue.serverTimestamp(),
      });
  console.log(writeResult);
});

方案2：单独导入FieldValue #

从firebase-admin/firestore模块直接导入FieldValue，避免链式访问的潜在问题：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";
import { FieldValue } from "firebase-admin/firestore";

admin.initializeApp();

const endpoint = functions.region("asia-northeast1");
export const test = endpoint.https.onCall(async (req) => {
  const original = req.hotelCode;
  const writeResult = await admin
      .firestore()
      .collection("messages")
      .add({
        original: original,
        created_at: FieldValue.serverTimestamp(),
      });
  console.log(writeResult);
});

额外排查步骤 #

若以上方案无效，尝试清理依赖后重新安装：

rm -rf node_modules package-lock.json
npm install

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