GASの自動処理が止まったら気づける｜try/catchとエラー通知メールの作り方

GASで自動化を作って、トリガー（＝決めた時間に関数を自動で動かす設定）で毎日動かす。最初の数日はうまくいっていたのに、ある日ふと見たら1週間前から止まっていた……。これ、自動化あるあるですよね。

私も、シート名をちょっと変えただけで毎朝の処理がこっそり失敗し続けていたことがあります。トリガーで動く処理は画面にエラーが出ないので、気づける仕組みを最初から入れておくのが大事なんです。

• GASの関数をトリガーで動かしたことがある、または動かす予定がある
• トリガーの付け方は GASを毎日自動で動かす｜時間主導型トリガーの設定手順 で解説しています
• 例ではスプレッドシートに紐づいたスクリプトを使います

まず知っておきたいのは、GASには最初から失敗通知の仕組みがあることです。公式ドキュメントによると、トリガーで動いた処理が失敗すると、画面にはエラーが出ない代わりに、Apps Scriptから失敗の概要メールが届きます。送信元は [email protected] です。

ただ、この標準の通知は受け取る頻度の設定によってはまとめて届き、中身も失敗の概要が中心です。そこで、

1. 処理を try/catch で包み、失敗した瞬間に自分の通知メールを送る
2. 通知を送ったらエラーをもう一度投げ直す（標準の通知と「実行数」の記録も残すため）

の二段構えにします。

失敗したときだけ通知し、エラーを投げ直す流れ

1. エディタ左側の「プロジェクト設定」（歯車のアイコン）を開く
2. 「スクリプト プロパティを追加」をクリックする
3. 「プロパティ」に NOTIFY_TO、「値」に通知を受けたいアドレス（例：[email protected]）を入れる
4. 「スクリプト プロパティを保存」をクリックする

次のコードを貼り付けて保存します。dailyJob が本来やりたい処理（ここでは例として「log」シートに1行書くだけ）で、トリガーには main を設定します。

// トリガーにはこの関数を設定する
function main() {
  runWithNotify_('毎朝のログ記録', dailyJob);
}

// 本来やりたい処理（例：logシートに1行追加）
function dailyJob() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('log');
  if (!sheet) throw new Error('シート「log」が見つかりません');
  sheet.appendRow([new Date(), 'dailyJob OK']);
}

// 処理を実行し、失敗したら通知してからエラーを投げ直す
function runWithNotify_(jobName, fn) {
  try {
    fn();
  } catch (e) {
    notifyError_(jobName, e);
    throw e; // 投げ直すと「実行数」に失敗が残り、Google標準の通知も届く
  }
}

function notifyError_(jobName, e) {
  const tz = Session.getScriptTimeZone();
  const now = Utilities.formatDate(new Date(), tz, 'yyyy/MM/dd HH:mm:ss');
  const message = (e && e.message) ? e.message : String(e);

  const body = [
    `「${jobName}」でエラーが起きました。`,
    '',
    `日時：${now}`,
    `メッセージ：${message}`,
    '',
    '詳細（どの関数の何行目か）：',
    (e && e.stack) ? e.stack : '（記録なし）',
    '',
    `スクリプトを開く：https://script.google.com/home/projects/${ScriptApp.getScriptId()}/edit`,
  ].join('\n');

  console.error(body); // メールが送れなくても「実行数」のログに残す

  const to = PropertiesService.getScriptProperties().getProperty('NOTIFY_TO');
  if (!to) {
    console.error('NOTIFY_TO が未設定のため、通知メールは送っていません');
    return;
  }
  try {
    MailApp.sendEmail(to, `【GASエラー】${jobName}：${message}`, body);
  } catch (mailError) {
    // 通知メール自体の失敗で、元のエラーが隠れないようにする
    console.error(`通知メールの送信にも失敗しました：${mailError.message}`);
  }
}

ポイントを補足しますね。

• e.message はエラーの短い説明、e.stack はどの関数の何行目で起きたかの記録です。両方あると、メールを見ただけで原因の見当がつきます
• console.error で書いた内容は、左側の「実行数」から該当の実行を開くと確認できます
• 通知メールの送信でさらにエラーが起きても、元のエラーを隠さないように、送信部分も try/catch で包んでいます
• 本来の処理が複数あるなら、runWithNotify_('別の処理名', 別の関数) のように使い回せます

通知の仕組みは、本当に失敗したときに初めて動くので、事前に1回試しておきましょう。いちばん簡単なのは、「log」シートの名前を一時的に「log_old」などに変えてから、main を手動で実行する方法です。

1. シート名を「log」から「log_old」に変える
2. エディタで main を選んで「実行」を押す（初回は承認の画面が出るので許可する）
3. 「シート「log」が見つかりません」というエラーで止まり、通知メールが届くことを確認する
4. シート名を「log」に戻す

なお、エディタから手動で実行したときは、Google標準の失敗通知は届きません。標準の通知の対象は、トリガーで動いたときの失敗です。この手順で届くのは自前の通知メールだけ、と考えてください。

最後に、トリガーの実行する関数を main にしておけば完成です。トリガーの設定画面では、Google標準の失敗通知をどの頻度で受け取るかも選べます。すぐ気づきたいなら、いちばん早く届く設定にしておくのがおすすめです。

自分の処理に組み込むときは、AIにこう頼むとスムーズです。

次のGoogle Apps Scriptに、エラー通知の仕組みを組み込みたいです。

【条件】
- 本来の処理は runWithNotify_('処理名', 関数) の形で呼び出す
- 失敗したら notifyError_ で通知メールを送り、そのあと throw e で投げ直す
- 通知先はスクリプトプロパティ NOTIFY_TO から読む（コードに書かない）
- APIキーなどの秘密の値はメール本文に入れない

【通知の仕組みのコード】
（runWithNotify_ と notifyError_ を貼る）

【組み込みたい処理のコード】
（ここに貼る）

ここは勘違いしやすいところです。try/catch は万能ではありません。

だからこそ、Google標準の失敗通知は切らずに残しておくのがおすすめです。自前の通知は「すぐ・詳しく」、標準の通知は「最後の砦」という役割分担ですね。

私が最初にやったミスは、catch の中で通知メールを送って満足し、throw e を書き忘れたことです。こうすると「実行数」では成功扱いになり、標準の通知も来ません。あとから履歴を見ても失敗がわからず、かなり困りました。

届いたエラーメッセージの意味がわからないときは、そのままAIに渡してしまいましょう。

Google Apps Scriptのトリガー処理で、次のエラー通知が届きました。

【エラーメッセージ】
（e.message の部分を貼る）

【スタック】
（e.stack の部分を貼る。メールアドレスやIDなど個人の情報は伏せる）

【処理の内容】
毎朝、スプレッドシートの「log」シートに1行追加するだけの処理です。

原因として考えられることと、確認する順番を教えてください。

• トリガーで動く処理はエラーが画面に出ない。だから「気づける仕組み」を先に入れる
• try/catch で通知メールを送り、throw e で投げ直して記録と標準通知も残す
• 時間切れや構文エラーは拾えないので、Google標準の失敗通知と「実行数」も併用する

次の一歩は、いま動かしている自動化を1つ選び、runWithNotify_ で包んでから、わざと失敗させて通知が届くか試してみることです。1回届けば、「止まっていたのに気づかない」不安からかなり解放されますよ。

GASの自動化を「作って終わり」ではなく、毎日安心して動かしたい方は、『Google Apps Script × 生成AI 全自動仕事術』も参考になります。生成AIに頼みながら、GASで仕事を自動化していきたい方向けの1冊です。

• トリガーの付け方から確認したい方へ：GASを毎日自動で動かす｜時間主導型トリガーの設定手順
• ログを別のシートに残したいなら：GoogleAppsScriptのログを別ファイルか別のスプレッドシートに書き出す方法
• サーバーの停止にも気づきたいなら：サーバーが止まったら知らせる｜Linuxの死活監視とn8n通知の入門【初心者向け】
• GASを順番に学びたい方へ：GAS学習の進め方｜既存記事をつなぐ学習マップ
• メンバーのKindle本の一覧：biliotechまわりのKindle著書リスト