Firebase Function调用Axios发POST请求出现invalid encoding序列化错误

Error: 13 INTERNAL: Request message serialization failure: invalid encoding 是Firebase Functions运行时抛出的gRPC序列化错误，并非请求目标接口返回的报错，本质是运行时尝试序列化数据传递给底层gRPC层时，遇到了非法JSON结构或不符合UTF-8编码的字符。

常见原因与对应解决办法 #

• 代码存在语法/字面量错误
  你贴的示例代码中data2: "data2, 缺少字符串闭合双引号，如果实际业务代码存在同类问题（未闭合的字符串、转义错误的特殊字符），会直接导致请求体为非法结构，序列化失败。先排查所有请求相关的字符串、变量取值是否合法。
• 授权凭证/请求参数存在编码异常
  检查API_KEY的取值，是否从其他渠道复制时带入了不可见的控制字符、零宽空格、非UTF-8编码的特殊符号，可以通过console.log(Buffer.from(API_KEY).toString('base64')) 打印验证编码是否正常。如果请求体字段是动态取值，也要确认没有undefined、未序列化的Buffer类型、编码异常的Emoji/特殊符号。
• Axios配置冗余冲突
  Axios POST请求传入JavaScript对象时会自动携带Content-Type: application/json请求头，手动指定该头可能在部分版本中与Firebase运行时的自动序列化逻辑冲突，可删除手动配置的Content-Type头重试。
• 返回值包含不可序列化内容
  如果请求完成后直接将完整的Axios响应对象result作为函数返回值，Axios响应对象内部存在循环引用、原生套接字引用、Buffer类型字段，无法被gRPC序列化。只需返回实际需要的业务数据即可，例如return result.data。

快速排查代码示例 #

try {
  const payload = {
    data1: "data1",
    data2: "data2"
  };
  // 提前验证序列化是否正常
  JSON.stringify(payload);
  JSON.stringify({ Authorization: `Bearer ${API_KEY}` });

  const result = await axios.post('https://example_api_url.com', payload, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  });
  // 仅返回业务数据
  return result.data;
} catch (e) {
  console.error('请求错误详情：', e.stack);
  throw new Error('请求处理失败');
}

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