Google Sheets values.append接口反复覆盖同一行而非新增行问题求助

1. 接口参数配置缺失：Google Sheets的spreadsheets.values.append接口默认insertDataOption为OVERWRITE模式，该模式下接口会先识别工作表的连续非空数据范围，若判定下一行存在可覆盖的空单元格，会直接覆盖该行而非插入新行，就是你遇到的反复覆盖同一行的问题。
2. 爬虫变量存在异常值：你爬取得到的变量中存在undefined、null、空值甚至未序列化的对象、嵌套数组这类异常值，一方面会导致接口判断连续非空范围时出现偏差，引发阶梯式错位；另一方面异常值会导致传入的内层数组元素个数和预期列数不匹配，进一步加重错位问题。

你传入字符串字面量时所有值都是有效非空字符串，刚好匹配列数，所以即使默认是覆盖模式也能正常写入。

• 新增insertDataOption参数，强制插入新行：在调用append的参数中增加insertDataOption: "INSERT_ROWS"，和valueInputOption平级，明确要求接口插入全新行，禁止覆盖已有行。
• 统一格式化所有爬虫变量：写一个简单的转换函数，把所有传入values的变量都转换成非空字符串，避免空值、异常类型导致的问题。
• 显式指定range的列范围：把原来只传工作表名的range改为指定完整列范围，比如"ECTRIMS v2!A:AQ"（你共有42个字段，对应A到AQ列），避免工作表其他位置的零散数据干扰接口的范围判断。

修复后代码示例 #

// 定义通用值格式化函数，统一处理异常值
const formatVal = (val) => {
  if (val === undefined || val === null) return ''
  return String(val).trim()
}

await googleSheets.spreadsheets.values.append({
  auth,
  spreadsheetId,
  range: "ECTRIMS v2!A:AQ", // 显式指定列范围，匹配42个字段的长度
  valueInputOption: "USER_ENTERED",
  insertDataOption: "INSERT_ROWS", // 强制插入新行，禁止覆盖
  resource: {
    values: [[
      formatVal(sEventID),
      formatVal(slastWideoutEdit),
      formatVal(scongressName),
      formatVal(scongressfullEventName),
      formatVal(scongressAbbrev),
      formatVal(scongressLocation),
      formatVal(scongressCity),
      formatVal(scongressCountry),
      formatVal(scongressYear),
      formatVal(scongressStartDate),
      formatVal(scongressEndDate),
      formatVal(scongressTime),
      formatVal(scongressUrl),
      formatVal(scongressUrlQuality),
      formatVal(scongressTwitterHashtag),
      formatVal(scongressPresenters),
      formatVal(scongressHCPAttendees),
      formatVal(scongressVirtual),
      formatVal(scongressType),
      formatVal(spresenterFirstName),
      formatVal(spresenterMiddleName),
      formatVal(spresenterLastName),
      formatVal(spresenterDegrees),
      formatVal(spresenterCity),
      formatVal(spresenterState),
      formatVal(spresenterCountry),
      formatVal(spresenterInstitution),
      formatVal(spresenterBio),
      formatVal(spresenterRole),
      formatVal(spresenterPresentationType),
      formatVal(spresenterPresentationID),
      formatVal(spresenterPresentationAbstract),
      formatVal(spresenterPresentationAbstractQuality),
      formatVal(spresenterPresentationUrl),
      formatVal(spresenterPresentationUrlQuality),
      formatVal(spresenterOralPoster),
      formatVal(spresenterSessionTitle),
      formatVal(spresentationDate),
      formatVal(spresentationStartTime),
      formatVal(spresentationEndTime),
      formatVal(spresentationTitle),
      formatVal(spresentationAbstract)
    ]],
  },
});

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