Firestore Cloud Function报错排查：新增Votes集合文档时更新Items集合文档votes字段失败

我来帮你定位这个问题的核心原因——你遇到的错误，本质是获取目标item ID的方式完全错了，导致构建Firestore文档路径时传入了空值。

错误根源分析 #

你的Cloud Function触发器定义的是：

functions.firestore.document("/Votes/{vote}")

这里的{vote}是路径参数，所以context.params对象里只会有vote这个键，根本不存在item_id。你代码里写的const item = context.params.item_id;会得到undefined，用它去创建items集合的文档引用时，就变成了items/undefined，这自然会触发Firestore的「路径必须是非空字符串」错误。

而根据你的需求，新增的投票文档里本身就包含item_id，所以正确的获取方式应该是从新增的Votes文档快照中提取这个字段，而不是从路径参数里找。

修正后的代码 #

我不仅帮你修复了错误，还优化了代码结构（用async/await替代回调链，避免Cloud Function提前终止），同时增加了错误检查：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";
admin.initializeApp();

export const vote = functions.firestore.document("/Votes/{voteId}")
.onCreate(async (snapshot, context) => {
  // 从新增的投票文档数据中获取item_id
  const voteData = snapshot.data();
  const itemId = voteData?.item_id;

  // 先检查item_id是否存在，避免再次触发路径错误
  if (!itemId) {
    console.error("错误：新增的投票文档中缺少item_id字段");
    return;
  }

  const itemDocRef = admin.firestore().collection("items").doc(itemId);
  
  try {
    const doc = await itemDocRef.get();
    if (doc.exists) {
      await itemDocRef.update({ 
        votes: admin.firestore.FieldValue.increment(1)
      });
      console.log(`成功更新item ${itemId}的投票数`);
    } else {
      console.log(`提示：item ${itemId}不存在，跳过投票数更新`);
    }
  } catch (err) {
    console.error("更新投票数时发生错误:", err);
  }
});

关键修正点说明 #

• 正确获取item_id：通过snapshot.data().item_id从新增的投票文档中提取目标item的ID，这才符合你的需求设定
• 使用async/await：替代原来的then回调链，让代码更易读，同时确保Cloud Function会等待所有异步操作完成后再终止，避免更新操作被中断
• 增加字段检查：提前判断item_id是否存在，避免因为文档缺少字段再次触发路径错误
• 完善日志：更清晰的日志输出，方便你调试和排查问题

最后再提醒一句：要确保新增的Votes文档里确实有item_id字段，并且字段名拼写完全一致（比如不要写成itemId或者item-id），否则还是会出现itemId为空的情况哦。

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