部署后调用含evox第三方API请求的Firebase云函数报错如何解决

1. 修复代码中的Promise反模式问题 #

现有代码用new Promise包裹async函数属于冗余写法，可能导致异常捕获逻辑异常，先按如下方式改写代码：

改写makeImagesRequest函数 #

const axios = require('axios').default;
const functions = require('firebase-functions'); // 补充缺失的functions引入，避免线上环境变量读取异常

module.exports.makeImagesRequest = async (vifNum) => {
  try {
    const productId = 0
    const productType = 0
    const imagesReqUrl = `http://api.evoximages.com/api/v1/vehicles/${vifNum}/products/${productId}/${productType}`
    const imagesRequestOptions = {
      url: imagesReqUrl,
      method: 'GET',
      headers: {
        'x-api-key': functions.config().evox.key,
        'Accept': 'application/json',
        'Content-Type': 'application/json;charset=UTF-8'
      }
    };
    const response = await axios(imagesRequestOptions);
    return { image: response.data.urls[0] }
  } catch(error) {
    // 线上环境打印错误日志，方便排查具体报错原因
    console.error('evox请求错误详情：', error.response?.data || error.message || error)
    throw { error, helperMsg: "Vif number is not valid or connection problem" }
  }
}

改写云函数导出代码 #

Firebase可调用云函数的错误必须用标准HttpsError抛出，否则客户端只会收到通用内部错误提示：

module.exports.getVehicleImages = functions.https.onCall(async (data, context) => {
  try {
    return await makeImagesRequest(data.vifNum)
  } catch(error) {
    console.error('云函数处理错误：', error)
    throw new functions.https.HttpsError('unknown', "Error while getting vehicle image by evox", error);
  }
})

2. 替换HTTP请求为HTTPS #

你当前调用的evox接口使用HTTP协议，大部分云服务默认会拦截非HTTPS的出站请求，先确认evox是否支持HTTPS访问，若支持直接把请求地址前缀改成https://api.evoximages.com即可。

3. 确认线上环境配置 #

你拉取的.runtimeconfig.json为本地缓存的配置，需执行以下命令确认线上实际配置是否正确：

firebase functions:config:get evox

如果是多环境部署，需要确认你部署的目标环境evox.key已正确配置。

4. 排查第三方API限制 #

多数带密钥的第三方API会开启IP白名单限制，本地测试时用的是你本机公网IP，Firebase云函数出口IP为Google Cloud的动态IP段，若evox开启了白名单，需要联系对方将Google Cloud函数出口IP段加入白名单，或确认evox没有IP访问限制。

5. 校验请求参数类型 #

你代码中vifNum要求是Number类型，可在函数入口打印typeof data.vifNum确认线上接收到的参数类型是否符合evox接口要求，避免字符串类型的数字导致请求参数异常。

内容的提问来源于stack exchange，提问作者Ahmet Yazıcı