Apps Script抛出“Exception: Illegal argument”无详情，如何定位具体错误？

不用逐行添加try-catch，试试这些更高效的方法：

• 利用执行日志与调试工具定位参数问题
  在调用内置服务（比如SpreadsheetApp、GmailApp）的关键位置，用console.log()输出待传入的参数值，比如要写入表格的数组、邮件收件人列表，直接看是否存在空值、格式错误或类型不匹配的情况。另外，用脚本编辑器的断点调试功能，在可疑代码行设置断点，运行时逐步查看变量状态，快速定位参数异常的环节。

• 核对内置服务方法的参数约束
  这个异常大多是因为违反了Apps Script内置服务的参数规则，比如调用setValues()时二维数组的行列数和目标单元格范围不匹配、GmailApp.sendEmail()的收件人格式不合法、DriveApp.createFile()传入了无效的文件内容等。直接对照官方文档，检查调用的方法对参数类型、取值范围、格式的要求，快速排查参数是否符合规范。

• 添加参数校验逻辑
  提前对关键参数做校验，在参数传入服务方法前抛出明确的错误，避免触发模糊的系统异常。比如校验邮箱格式、单元格范围有效性：

  // 校验邮箱格式
  function checkValidEmail(email) {
    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
    if (!emailRegex.test(email)) {
      throw new Error(`非法邮箱地址：${email}`);
    }
  }
  
  // 校验单元格范围是否合法
  function checkValidRange(rangeStr) {
    if (!/^[A-Z]+\d+(:[A-Z]+\d+)?$/.test(rangeStr)) {
      throw new Error(`非法单元格范围：${rangeStr}`);
    }
  }
  

• 优化try-catch获取详细堆栈信息
  不用逐行加try-catch，在顶层入口函数添加统一的捕获逻辑，打印错误的堆栈信息，直接定位到异常发生的具体行号：

  function main() {
    try {
      // 你的业务逻辑代码
      processData();
      sendNotification();
    } catch (error) {
      console.error('错误堆栈:', error.stack);
      throw error;
    }
  }
  

  堆栈信息会明确显示错误触发的函数和行号，比逐行排查效率高得多。

• 拆分复杂函数为小模块
  把包含多步操作的大函数拆分为单一职责的小函数（比如数据读取、数据处理、结果推送），单独测试每个小函数，快速锁定哪个模块的参数出现问题。比如把原来的handleAllTasks()拆成fetchSheetData()、transformData()、writeBackToSheet()，逐个验证即可。

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