GAS『Unknown Error Occurred』の原因と対処法
- 2025.10.31
実行中にApps Script実行環境が特定の例外名を割り当てられず、汎用の「Unknown Error Occurred」として失敗するケース。典型要因は一時的なバックエンド障害、ネットワークやDNSの瞬断、レスポンスや入出力の想定外、実行コンテキストの不整合、競合やロック、レート/クォータ境界付 […]
実行中にApps Script実行環境が特定の例外名を割り当てられず、汎用の「Unknown Error Occurred」として失敗するケース。典型要因は一時的なバックエンド障害、ネットワークやDNSの瞬断、レスポンスや入出力の想定外、実行コンテキストの不整合、競合やロック、レート/クォータ境界付 […]
Google Apps Scriptや内部Googleサービスが一時的に失敗したときに返る汎用エラー。ネットワークの瞬断、バックエンドの一時障害、レート/同時実行の突発上限、巨大ペイロード、長時間ロック、タイムアウト連鎖などが誘因。恒久的なバグと切り分け、指数バックオフ・チャンク処理・同時実行制御・ […]
「DriveApp はこのコンテキストでは使えません」は、現在の実行文脈(コンテキスト)が DriveApp のような“要認可サービス”を許可していないときに発生。代表例は「カスタム関数」「シンプルトリガー」「クライアント側(ブラウザ)からの直接実行」。実行主体・入口・スコープの一致を取り、必要なら […]
JavaScriptの構文解析がファイルの末尾まで来ても閉じるべき記号やコメントが見つからないと発生。閉じ忘れ(}, ], ), “, ‘, `, */)、テンプレートリテラルや正規表現の崩れ、HTMLサービスでの誤終端、マージ時の欠落や不可視文字が主因。発生行の「直前」を疑 […]
実行中の例外がtry/catchで捕捉されずに上位まで伝播したときに出る。典型原因は「null参照・型不一致などのプログラムエラー」「権限/配信上限/レート制限などの実行環境エラー」「外部APIやネットワークの一時障害」。最短復旧は再現箇所の特定→防御的コーディング→エラー分類(再試行すべき/すべき […]
ブラウザから別オリジンのGoogle Apps Script(Webアプリ)や外部サイトへアクセスしたとき、CORS/同一生成元ポリシー、X-Frame-Options、Mixed Contentなどの制限でブロックされる。Apps ScriptはHTTPレスポンスヘッダを自由に設定できないため、U […]
Google Apps Script(MailApp/GmailApp)で1日に送信できる受信者数の上限を超えると発生する。To/Cc/Bccの総受信者数がカウント対象で、アカウント種別(Google Workspace/個人Gmail)やセキュリティ状態によって上限が異なる。重複宛先や無駄な再送を […]
Google Apps Script(V8)の構文解析で「その位置に現れてはいけない文字/記号が来た」と判断されると発生する。波括弧や括弧の不一致、カンマの欠落・余分、全角記号やスマートクォートの混入、JSONとオブジェクトの取り違え、awaitの誤用、import/exportの誤解などが典型。エ […]
Google Apps Scriptから外部API/Google APIにOAuth2で接続するとき、認可フローやクライアント設定、リダイレクトURI、スコープ、トークン保存の不整合で失敗する。ここでは発生条件の整理、最短復旧の手順、実用テンプレコード、典型的なエラーごとの修正ポイントをまとめる。 […]
Google Apps Scriptで「Cannot find method xxx(…)」は、呼び出したメソッド名や引数の型・個数が、受け手のオブジェクトやそのオーバーロードと一致しないときに出る。典型は setValues に1次元配列、Calendar の createEvent に文字列日時 […]