向BigQuery表插入数据触发PartialFailureError错误如何解决？

核心前置问题（优先级最高的两个错误） #

• 字段类型不匹配：你的表结构中campaigns是REPEATED RECORD类型，对应JavaScript中的数组结构，但你构造的campaigns是单个对象，不符合数组格式要求
• 字段名不匹配：RECORD内部的主键段名是campaign_id，但你构造的对象中用的是id，字段名没有和表结构对齐

完整排查步骤 #

1. 先修复已知的结构错误 #

修正后的row构造代码参考：

const row = {
  hotel_name: hotel_name,//string
  // campaigns改为数组格式，哪怕只有1个元素也要套数组
  campaigns: [
    {
      // 字段名调整为和表结构一致的campaign_id
      campaign_id: item.id,//string
      platform_id: item.platform_id,//int
      platform_name: item.platform_name,//string
      reporting_id: item.reporting_id,//string
    }
  ]
};

2. 开启错误详情打印，定位剩余问题 #

PartialFailureError默认不会输出明细报错，你可以在插入逻辑的catch块中打印错误的errors字段，即可获取精准的行/字段级错误原因：

try {
  await bigqueryClient
    .dataset(DATASET_ID)
    .table(TABLE_ID)
    .insert(row);
} catch (e) {
  if (e.name === 'PartialFailureError') {
    // 打印具体错误明细，会明确提示字段不匹配、类型错误等具体问题
    console.error('插入错误详情：', JSON.stringify(e.errors, null, 2));
  }
  throw e;
}

3. 其他潜在排查点 #

• 检查platform_id的传入格式：表结构是NUMERIC类型，如果你传入的是JavaScript的number类型，建议转为字符串后再传入，避免精度丢失触发类型校验失败
• 确认云函数的服务账号拥有对应BigQuery表的bigquery.tables.insert权限，权限不足也可能触发该类错误
• 如果需要插入多条数据，统一传入数组调用insert方法即可，不要循环单条插入避免触发限流

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