Firebase CLI本地调用含Firestore数据的云函数报错求助

嘿，我来帮你理清这个问题！首先先解决你遇到的错误，再纠正你对函数调用的误解：

1. 错误根源：original变量根本没定义 #

你代码里的admin.firestore().collection('messages').add({original: original});这一行有个致命问题——original变量完全没被赋值！Firestore没法把undefined类型的数据存入数据库，所以才抛出了Cannot encode type ([object Undefined])这个错误。

先把你的函数代码修复好：

// src/add-message/index.ts
import * as functions from 'firebase-functions'
import * as admin from 'firebase-admin'; // 别忘了导入admin SDK，你之前漏了这个！

admin.initializeApp(); // 必须初始化admin才能调用Firestore

export const listener = functions.https.onRequest((req, res) => {
  // 从请求里拿参数：可以是GET请求的query，或者POST请求的body
  const original = req.query.original || req.body.original || '默认消息';
  
  // 一定要用then/catch处理异步操作，避免未处理的Promise
  admin.firestore().collection('messages').add({original: original})
    .then(() => {
      res.send("hello from firebase!");
    })
    .catch(err => {
      res.status(500).send(`添加消息出错：${err}`);
    });
})

这里要注意两个关键点：

• 必须导入并初始化firebase-admin，不然连Firestore都调用不了
• 从请求对象req里获取original参数，不能凭空用一个未定义的变量

2. 别误解文档！HTTP触发函数不能直接输addMessage()调用 #

你之前的理解错了——不是所有云函数都能在shell里直接输函数名调用！你的addMessage是https.onRequest类型的HTTP触发函数，这类函数需要接收request（HTTP请求）和response（HTTP响应）两个参数，所以直接输addMessage()肯定会报错。

当你运行firebase experimental:functions:shell后，正确的调用方式是模拟这两个参数：

// 模拟GET请求，传入query参数
addMessage({ query: { original: "我的测试消息" } }, { 
  send: (msg) => console.log(msg),
  status: (code) => ({ send: (err) => console.log(`状态码${code}：${err}`) })
})

如果你的函数是通过POST请求接收参数，就这么调：

addMessage({ body: { original: "POST过来的消息" }, method: 'POST' }, { 
  send: (msg) => console.log(msg),
  status: (code) => ({ send: (err) => console.log(`状态码${code}：${err}`) })
})

另外，shell里还支持用http命令模拟HTTP请求，比如：

http('GET', '/addMessage?original=Hello%20Shell')

3. 额外小知识：可调用函数才支持直接传参调用 #

如果你的函数是用functions.https.onCall定义的可调用函数，那确实可以在shell里直接传参数调用，比如：

// 可调用函数示例
export const addMessage = functions.https.onCall((data, context) => {
  const original = data.original;
  return admin.firestore().collection('messages').add({original})
    .then(() => {
      return { message: "消息添加成功！" };
    });
})

这时在shell里就可以直接调用：

addMessage({ original: "测试可调用函数" })

但你的函数是HTTP触发类型，所以必须模拟请求响应对象才行。

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