使用axios配合Firebase Functions发送POST请求时部署代码报错

通过axios结合Firebase Cloud Function发送POST请求，请求体携带实时数据库变更监听到的数据，部署代码时触发如下报错：

Function failed on loading user code. This is likely due to a bug in the user code. 
Error message: Error: please examine your function logs to see the error cause: 
Additional troubleshooting documentation can be found at logging related troubleshooting page. Please visit 
the functions troubleshooting page for in-depth troubleshooting documentation.

作为Firebase Functions新手，查阅资料后仍无法定位问题，业务代码如下：

const functions = require("firebase-functions");
const axios = require("axios");

exports.newNodeDetected = functions.database
    .ref("Orders/{userId}/{customerId}/{ordernum}/customername")
    .onCreate((snapchot, context) => {
      const order = snapchot.val();
      const userId = context.params.userId;
      console.log(userId + "AND CUS NAME IS" + order);

      axios.post("http://something.com/data.php", {
        username: userId,
        title: "ttl",
        message: "msg",
      })
          .then(function(response) {
            console.log(response);
          })
          .catch(function(error) {
            console.log(error);
          });
    });

• 最核心的部署加载失败原因：未正确安装axios依赖。绝大多数新手写Functions时，会在项目根目录执行npm安装命令，但Firebase部署时只会上传functions目录下的node_modules和package.json，如果没在functions目录下安装axios，云端运行环境找不到依赖包，直接触发代码加载失败。
• 逻辑缺陷：Firebase触发类函数必须返回所有异步操作的Promise，否则函数在执行完同步逻辑后会被立即回收，当前代码没有return axios请求的Promise，就算部署成功，实际触发时POST请求大概率会在发送中途被终止。
• 笔误：回调参数写为snapchot，正确拼写应为snapshot，该笔误不会直接导致加载失败，但容易引发后续取值异常。

1. 终端进入本地项目的functions文件夹（必须是存放Functions相关package.json的子目录，不是项目根目录），执行依赖安装命令：

npm install axios

安装完成后打开functions/package.json，确认dependencies字段中存在axios条目，再执行部署即可解决依赖缺失导致的加载报错。
2. 修正代码逻辑，补全Promise返回、修正拼写错误，修复后代码如下：

const functions = require("firebase-functions");
const axios = require("axios");

exports.newNodeDetected = functions.database
    .ref("Orders/{userId}/{customerId}/{ordernum}/customername")
    .onCreate((snapshot, context) => {
      const order = snapshot.val();
      const userId = context.params.userId;
      console.log(`${userId} AND CUS NAME IS ${order}`);

      // 必须返回异步请求的Promise，告知Functions等待异步操作执行完成
      return axios.post("http://something.com/data.php", {
        username: userId,
        title: "ttl",
        message: "msg",
      })
          .then(function(response) {
            console.log("请求响应：", response.data);
            return null;
          })
          .catch(function(error) {
            console.log("请求异常：", error);
            return null;
          });
    });

3. 额外注意：Firebase Functions运行环境默认对非HTTPS的出站请求有拦截限制，如果目标接口是HTTP协议，建议替换为HTTPS地址，避免请求被防火墙拦截。

如果完成上述操作后部署仍报加载错误，直接查看Firebase控制台的函数运行日志，日志会打印具体的错误栈（比如语法错误、依赖版本冲突、权限配置问题），不要只看部署时返回的通用错误提示。

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