如何将配置定时触发器的Google AppScript错误日志发送至Slack

第一步：准备专属Slack Webhook地址 #

你需要先在自己的Slack工作区内完成传入Webhook的配置，拿到专属的请求地址，这个地址是后续推送消息的唯一入口，注意不要泄露该地址，避免无关人员往频道发送恶意内容。

第二步：编写通用错误推送函数 #

这个函数可以直接复用，不管是单项目使用还是多项目统一维护都适用，把以下代码放到你的AppScript项目中：

// 替换成你第一步拿到的Slack Webhook地址
const SLACK_WEBHOOK = "你的专属Slack Webhook地址";

function pushErrorToSlack(e) {
  // 提取异常上下文，做兜底处理避免参数缺失导致报错
  const scriptName = ScriptApp.getScriptTitle();
  const errorReason = e?.reason || "未捕获明确错误原因";
  const errorStack = e?.stack || "无完整错误堆栈信息";
  const triggerSource = e?.trigger?.eventType || "非定时任务触发的执行";
  const occurTime = new Date().toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" });

  // 组装Slack富文本消息，可根据需求调整排版、@规则
  const payload = {
    text: "AppScript运行错误告警",
    blocks: [
      {
        type: "header",
        text: { type: "plain_text", text: "🚨 定时任务运行异常" }
      },
      {
        type: "section",
        fields: [
          { type: "mrkdwn", text: `*所属项目：*\n${scriptName}` },
          { type: "mrkdwn", text: `*发生时间：*\n${occurTime}` },
          { type: "mrkdwn", text: `*触发来源：*\n${triggerSource}` },
          { type: "mrkdwn", text: `*错误原因：*\n${errorReason}` }
        ]
      },
      {
        type: "section",
        text: { type: "mrkdwn", text: `*错误堆栈详情：*\n\`\`\`${errorStack}\`\`\`` }
      }
    ]
  };

  // 发送请求到Slack
  UrlFetchApp.fetch(SLACK_WEBHOOK, {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  });
}

配置说明：

• 参数e是AppScript错误触发器自动传入的异常对象，不需要手动赋值
• muteHttpExceptions: true的作用是避免Slack请求失败时反向触发新的错误告警，造成循环通知
• 你可以直接修改blocks里的消息结构，适配你的Slack频道的通知习惯，比如添加@指定负责人、告警等级标签等内容

第三步：替换原有邮件通知逻辑 #

针对你已经配置好的每小时定时触发器，不需要修改原有业务逻辑的触发规则，只需要完成以下配置替换原有邮件告警：

• 打开对应AppScript项目的触发器配置页面
• 选择添加新触发器，触发条件设置为应用执行出现错误时触发
• 选择执行函数为我们刚才写的pushErrorToSlack
• 保存触发器后，找到原有每小时运行的定时触发器，进入详情页关闭「执行出错时发送邮件通知」的选项即可

多项目复用优化方案 #

如果你的AppScript项目数量较多，逐个重复配置推送函数效率很低，可以做统一复用改造：

• 把上述pushErrorToSlack的公共代码放到一个独立的AppScript项目中，将其发布为可访问的公共库
• 每个业务项目直接引入这个公共库，不需要重复编写推送代码
• 每个业务项目里只需要写一个极简的错误处理入口函数，直接绑定到错误触发器上即可：

// 每个业务项目的专属错误入口
function onProjectError(e) {
  // 调用公共库的推送方法
  你的公共库标识.pushErrorToSlack(e);
}

后续如果需要调整Slack消息格式、修改推送逻辑，只需要更新公共库的代码，所有接入的项目都会同步生效，不用逐个迭代。

配置验证方法 #

所有配置完成后，手动验证一次推送链路是否正常：

• 新建一个临时测试函数，主动抛出模拟错误

function testAlert() {
  throw new Error("这是测试告警的模拟错误，验证Slack通知是否正常");
}

• 手动执行这个测试函数，正常情况下对应的Slack频道会立刻收到错误告警，收到消息后删掉测试函数即可。

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