GAS『Script Function Not Found』の原因と対処法

・エディタの実行/Runメニューで指定した関数が存在しない
・ウェブアプリURLにアクセスしたが doGet/doPost が無い
・HTMLサービスの google.script.run で呼んだサーバ関数が無い
・シンプルトリガー（onOpen/onEditなど）の名前が不正
・インストール型トリガーが削除/改名済みの関数を指している
・ライブラリ/デプロイ（clasp含む）が古い版を参照している

□ 呼び出し名と定義名は完全一致か（大文字/小文字/全角無し）
□ 関数はトップレベル（グローバル）で定義されているか（IIFE/{} 内ではない）
□ 全ファイルを保存したか（⌘/Ctrl+S）／構文エラーが残っていないか
□ ウェブアプリは doGet/doPost を定義し、新バージョンでデプロイ済みか
□ トリガーが存在し、正しい関数名を指しているか（削除した関数名になっていないか）
□ ライブラリ/バージョン/スクリプトIDが想定のものか

// NG：大文字小文字が違う
function myFunc() {}
function run() { myfunc(); }  // Script function not found: myfunc

// OK：完全一致
function myFunc() {}
function run() { myFunc(); }

// NG：全角混入（見た目が似ていても別文字）
function doPost(e) {}
function test() { doＰost({}); } // Ｐ が全角 → not found

// 対処：呼び出し箇所をコピペで置換、全角・空白を排除

// NG：doGet 未定義でURLにアクセス → Script function not found: doGet
// OK：エントリを定義
function doGet(e) {
  return HtmlService.createHtmlOutput('OK');
}
function doPost(e) {
  return ContentService.createTextOutput('POST OK');
}

// 手順
// 1) 関数を定義 → 2) ファイル保存 → 3) 「新バージョンとしてデプロイ」→ 4) 最新URLで確認

// Code.gs（サーバ）
function addRow(values) {
  const sh = SpreadsheetApp.getActiveSheet();
  sh.appendRow(values);
}

// index.html（クライアント）
<script>
  function submit() {
    const values = ['A','B','C'];
    google.script.run
      .withSuccessHandler(() => alert('done'))
      .addRow(values);     // ← addRow と完全一致
  }
</script>

// NG例：.addrow と書く／IIFE内の関数を呼ぶ → not found

// NG：シンプルトリガー名が誤り（onedit など）
function onedit(e) {} // 実行されず、期待動作にならない

// OK：正しい関数名
function onEdit(e) { /* ... */ }

// インストール型トリガーが古い関数名を指している場合の修正
function listTriggers() {
  ScriptApp.getProjectTriggers().forEach(t =>
    console.log(t.getHandlerFunction(), t.getEventType()));
}
function resetTrigger() {
  // 古いトリガーを削除して再作成
  ScriptApp.getProjectTriggers().forEach(t => ScriptApp.deleteTrigger(t));
  ScriptApp.newTrigger('batchJob').timeBased().everyMinutes(5).create();
}
function batchJob() { /* 本処理 */ }

// NG：IIFEの内側 → グローバルから見えない
(() => {
  function hidden() {}
})();
function run() { hidden(); } // not found

// OK：トップレベル関数として定義
function visible() {}
function run() { visible(); }

// NG：ブロックスコープ内
{
  function localOnly() {}
}
function run2() { localOnly(); } // not found

// 診断：実行中プロジェクトのスクリプトIDを確認
function whoAmI() {
  console.log('scriptId:', ScriptApp.getScriptId());
}

// 対処の方針
// ・ライブラリ：プロジェクト設定→ライブラリ→参照バージョンを最新に
// ・ウェブアプリ：新バージョンとしてデプロイ（URLは同じでも中身は更新が必要）
// ・clasp：push 後にエディタで反映を確認、必要なら再デプロイ

// 1) すべてのタブを保存（⌘/Ctrl+S）
// 2) エディタの問題タブ/コンソールで構文エラーがないか確認
// 3) 実行ログ（Executions）で失敗原因を確認

function listGlobals() {
  const names = Object.keys(this).filter(k => typeof this[k] === 'function');
  names.sort();
  console.log(names.join(', ')); // ここに呼びたい関数名が出ているか確認
}
function assertFunction(name) {
  if (typeof this[name] !== 'function') {
    throw new Error('関数が見つかりません: ' + name);
  }
}

// NG
// （doGetが無い状態でURLアクセス）→ Script function not found: doGet

// OK
function doGet(e) {
  return HtmlService.createHtmlOutputFromFile('index');
}

// Code.gs（OK版）
function saveRow(v) {
  SpreadsheetApp.getActiveSheet().appendRow(v);
}
// index.html（OK版）
<script>
  function send() {
    google.script.run.withSuccessHandler(() => alert('saved')).saveRow(['a','b']);
  }
</script>

// 旧：function job() {}
// 新：function batchJob() {}
// → 旧トリガーは 'job' を指し続けるので not found

function migrateTrigger() {
  ScriptApp.getProjectTriggers().forEach(t => ScriptApp.deleteTrigger(t));
  ScriptApp.newTrigger('batchJob').timeBased().everyMinutes(10).create();
}

・エントリポイント（doGet/doPost/onEdit/onOpen/バッチ関数）は1ファイルに集約
・改名時は「検索置換 → トリガー再作成 → 新バージョンで再デプロイ」をセット運用
・google.script.run で呼ぶ関数は .gs のトップレベルのみを約束
・レビュー時に listGlobals() の出力で存在確認
・clasp/ライブラリは参照バージョンとスクリプトIDをREADMEに明記

□ 呼び出し名＝定義名が完全一致（大/小/全角なし）
□ トップレベル関数として定義（IIFE/ブロック外）
□ すべて保存済み、構文エラーなし
□ ウェブアプリの doGet/doPost を定義して「新バージョンでデプロイ」
□ トリガーが正しい関数名を指している（不要なものは削除）
□ ライブラリ/デプロイの参照バージョンが最新
□ listGlobals() に目的の関数名が現れる