Golang BigQuery插入Repeated数组失败：quality字段为NULL无报错

问题场景 #

使用Golang的BigQuery库向表中插入数据，其中quality字段为Repeated（可重复）类型，代码中已为该字段赋值非空数组，但插入后BigQuery中该字段显示为NULL，且无任何报错。

相关代码如下：

表Schema定义 #

tableSchema := bigquery.Schema{
    {Name: "issue_id", Type: bigquery.StringFieldType},
    {Name: "quality", Type: bigquery.StringFieldType, Repeated: true},
    {Name: "creation_date_ts", Type: bigquery.TimestampFieldType},
}

对应结构体 #

type escalationsRecord struct {
    IssueID      bigquery.NullString    `bigquery:"issue_id"`
    Quality      []string               `bigquery:"quality"`
    CreationTime bigquery.NullTimestamp `bigquery:"creation_date_ts"`
}

数据插入代码 #

record := escalationsRecord{
        IssueID:      bigquery.NullString{StringVal: fmt.Sprint(int(issue.Number)), Valid: true},
        Quality:      qualityArray, // 确认该数组包含有效元素
        CreationTime: bigquery.NullTimestamp{Timestamp: issue.CreatedAt.Time, Valid: true},
    }
records = append(records, &record) 

inserter := table.Inserter()
err2 := inserter.Put(b.ctx, records)

解决步骤 #

• 开启严格插入模式，暴露隐性错误
  默认情况下BigQuery Inserter会跳过无效行且不返回错误，开启严格模式后，任何插入错误都会直接抛出，帮助定位问题：

  inserter := table.Inserter()
  inserter.Strict = true // 开启严格校验
  err2 := inserter.Put(b.ctx, records)
  if err2 != nil {
      log.Fatalf("插入失败: %v", err2)
  }
  

• 校验数组的实际状态
  在赋值前打印数组的长度和元素，确认其不是nil或空数组：

  log.Printf("Quality数组长度: %d, 元素: %v", len(qualityArray), qualityArray)
  // 再进行赋值和插入操作
  

• 用map类型替代结构体插入，验证映射问题
  暂时绕过结构体映射，直接用map[string]bigquery.Value构造数据，确认是否能正常插入：

  records := []map[string]bigquery.Value{}
  recordMap := map[string]bigquery.Value{
      "issue_id":         fmt.Sprint(int(issue.Number)),
      "quality":          qualityArray,
      "creation_date_ts": issue.CreatedAt.Time,
  }
  records = append(records, recordMap)
  
  inserter := table.Inserter()
  err := inserter.Put(b.ctx, records)
  if err != nil {
      log.Fatal(err)
  }
  

• 确认表Schema与代码定义一致
  登录BigQuery控制台，检查目标表的Schema，确保quality字段确实是STRING类型、可重复（Repeated），没有被误修改为其他类型。

• 升级BigQuery库版本
  如果以上步骤都无效，尝试升级cloud.google.com/go/bigquery到最新版本，避免因旧版本的Bug导致字段映射失败。

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