使用IMPORTRANGE后粘贴值失败：afterLastRow为布尔值不符copyValuesToRange整数要求

看起来你遇到的核心问题是afterLastRow意外变成了布尔值，而copyValuesToRange要求传入整数类型的行号参数。我来帮你拆解问题根源和解决办法：

一、先排查afterLastRow的计算逻辑 #

最常见的原因是你在计算这个变量时，误将布尔判断的结果赋值给了它，而不是获取实际的行号。比如下面这种错误写法：

// ❌ 错误：isEmpty()返回布尔值（true/false），不是行号
var afterLastRow = sheet.getRange(sheet.getLastRow() + 1, 1).isEmpty();

正确的写法应该是直接获取目标行号，比如要获取源数据下方的第一个空行行号：

// ✅ 正确：获取最后一行的下一行行号（整数类型）
var afterLastRow = sheet.getLastRow() + 1;

如果你的需求是找到第一个真正空的行（比如中间有空白行的情况），可以用循环来获取行号，确保返回的是整数：

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你的IMPORTRANGE标签页");
var afterLastRow = 1;
// 循环找到第一个空行
while (sheet.getRange(afterLastRow, 1).getValue() !== "") {
  afterLastRow++;
}

二、处理IMPORTRANGE的异步加载特性 #

因为IMPORTRANGE是异步加载数据的，如果你的脚本在数据还没完全加载完成时就运行，getLastRow()可能返回0，后续的计算逻辑如果处理不当，也可能导致afterLastRow变成非整数（比如误加了布尔值）。

可以加一个等待逻辑，确保数据加载完成后再计算行号：

var sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("IMPORTRANGE标签页");
// 等待数据加载完成（最多等待10秒）
var waitCount = 0;
while (sourceSheet.getLastRow() === 0 && waitCount < 10) {
  SpreadsheetApp.flush(); // 强制刷新数据
  Utilities.sleep(1000); // 等待1秒
  waitCount++;
}
// 确认数据加载完成后再计算行号
if (sourceSheet.getLastRow() === 0) {
  throw new Error("IMPORTRANGE数据加载超时，请检查权限或数据源链接");
}
var afterLastRow = sourceSheet.getLastRow() + 1;

三、添加参数类型校验（可选但推荐） #

为了避免类似问题再次发生，可以在调用copyValuesToRange前，先校验afterLastRow的类型：

if (typeof afterLastRow !== 'number' || !Number.isInteger(afterLastRow)) {
  throw new Error(`无效的行号参数：afterLastRow的值是${afterLastRow}，需要整数类型`);
}
// 执行复制操作
sourceSheet.getDataRange().copyValuesToRange(
  targetSheet, // 目标工作表
  1, // 起始列
  sourceSheet.getLastColumn(), // 结束列
  afterLastRow, // 起始行
  afterLastRow + sourceSheet.getLastRow() - 1 // 结束行
);

内容的提问来源于stack exchange，提问作者Wellyngton Marcondes LATAM