GASで「Cannot read properties of null」と出るときの直し方(シート名の違いを見つける)

記事
IT・テクノロジー
GAS(Google Apps Script)を動かしたら、「TypeError: Cannot read properties of null (reading 'getRange')」という英語のエラーで止まった。ネットで見つけたコードや、AI に作ってもらったコードを貼りつけたときに、とてもよく出るエラーです。

このエラーは「空っぽ(null)のものから getRange を呼ぼうとした」という意味です。多くの場合、その前の行でシートを取り出すのに失敗しています。この記事では、原因の見つけ方と、次から同じことで迷わないための書き方をまとめました。

■ まず、エラーの文の「reading '○○'」を見る
かっこの中の言葉が、呼ぼうとして失敗したものです。
・reading 'getRange'、'getLastRow'、'getDataRange' → ほとんどが「シートが見つからなかった」
・null ではなく「undefined (reading 'range')」と出る → onEdit などを、エディタの「実行」ボタンで動かした
・reading 'getSheetByName' → スプレッドシートそのものが開けていない

エラーの行の番号(「コード.gs:5」など)も出ているので、その 1 行前を見ると原因が見つかります。

■ 原因 1:シートの名前が、コードと少し違う(いちばん多い)
たとえばコードに getSheetByName('名簿') と書いてあるのに、シートのタブの名前が次のようになっていると、シートが見つからず null になります。
・「名簿 」のように、うしろに空白が入っている
・「シート1」と「シート1」のように、数字が全角と半角で違う
・「Sheet1」のまま、名前を変えていない

見た目では違いが分かりにくいので、コードに見つけてもらうのが早いです。次の関数を使うと、見つからなかったときに「似た名前のシートがあります」「今あるシートはこれです」と日本語で教えてくれます。

function getSheetOrStop(name) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  if (!ss) {
    throw new Error('スプレッドシートが開けません。シートの「拡張機能 → Apps Script」から作ったスクリプトか確かめてください。');
  }
  const sheet = ss.getSheetByName(name);
  if (sheet) return sheet;
  const norm = s => String(s).normalize('NFKC').replace(/\s/g, '');
  const names = ss.getSheets().map(s => s.getName());
  const near = names.filter(n => norm(n) === norm(name));
  if (near.length > 0) {
    throw new Error('シート「' + name + '」が見つかりません。似た名前のシート「' + near[0] + '」があります(空白や全角・半角の違い)。');
  }
  throw new Error('シート「' + name + '」が見つかりません。今あるシート:' + names.join('、'));
}

使い方は、今のコードの
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('名簿');
を
const sheet = getSheetOrStop('名簿');
に置きかえるだけです。違っていたら、シートのタブの名前か、コードの名前のどちらかにそろえてください。

■ 原因 2:onEdit などを、エディタの「実行」で動かした
onEdit(e) のような関数は、シートを編集したときに Google が e(どこが編集されたか)を渡してくれます。エディタの「実行」ボタンで動かすと e が空っぽなので、e.range を読んだところで止まります。この場合は、コードが悪いのではなく、試し方が違います。シートのセルを実際に書きかえて試してください。

エディタから押してしまっても止まらないように、最初に確かめておくと安心です。

function onEdit(e) {
  if (!e) {
    Logger.log('この関数はシートを編集したときに自動で動きます。エディタから実行しても動きません。');
    return;
  }
  const range = e.range;
  Logger.log(range.getSheet().getName() + ' の ' + range.getRow() + ' 行目が編集されました');
}

■ 原因 3:スプレッドシートに紐づいていないスクリプト
Google ドライブの「新規 → Apps Script」から作ったスクリプトは、どのスプレッドシートにも紐づいていません。この場合 SpreadsheetApp.getActiveSpreadsheet() が空っぽになります。スプレッドシートを開いて「拡張機能 → Apps Script」から作り直すか、SpreadsheetApp.openById('スプレッドシートのID') で開く書き方にします。

■ つまずきやすいところ
・シートの名前を変えると、コードの中の名前は自動では変わりません。あとで名前を変えるときは、コードの方も直してください
・コピーしたスプレッドシートでは、スクリプトも一緒にコピーされますが、トリガーはコピーされません。動かないときはトリガーも確かめてください
・試すときは、本番のシートのコピーで試すと安心です

■ 自分で直すのが大変なときは
「どの行が悪いのか分からない」「AI に作ってもらったコードが動かない」「直したら別のエラーが出た」といったときは、次の出品でお手伝いしています。
・GAS・Python・VBA のエラーを直します:https://coconala.com/services/4455210
・GAS でスプレッドシートの転記・集計を自動化します:https://coconala.com/services/4455227

あわせて読みたい:
・GASで「Service invoked too many times」と出て止まるときの直し方 https://coconala.com/blogs/6357864/846754
・GASが「最大実行時間を超えました」で止まるときの直し方 https://coconala.com/blogs/6357864/838238
・GASを毎朝決まった時間に自動で動かす方法(トリガーの設定) https://coconala.com/blogs/6357864/829488

この記事は、AI(Claude)の助けを借りて書いています。コードは、テスト用のデータで動きを確かめてから載せています。
サービス数100万件のスキルマーケット、あなたにぴったりのサービスを探す