GAS(Google Apps Script)を動かしたら、「TypeError: Cannot read properties of null (reading 'getRange')」と出て止まってしまった。昨日まで動いていたのに、急にこのエラーが出るようになった。そんなご相談をよくいただきます。
このエラーは「取ってこようとしたものが見つからず、空っぽ(null)だった」という意味です。括弧の中の getRange の部分は、getLastRow や getValues など、場面によって変わります。どれも原因の探し方は同じです。この記事では、よくある原因を3つと、それぞれの直し方を紹介します。
■ 原因1:シートの名前が合っていない
一番多いのがこれです。
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('売上');
const lastRow = sheet.getLastRow();
getSheetByName は、指定した名前のシートが見つからないと null を返します。その null に対して getLastRow を呼ぶので、エラーになります。
よくあるのは次のような場面です。
・だれかがシートの名前を変えた(「売上」→「売上2026」など)
・名前の前後に、見えないスペースが入っている
・全角と半角が違う(「売上1」と「売上1」など)
直し方:まず、実際のシート名を一覧で出して見比べます。
const names = SpreadsheetApp.getActiveSpreadsheet().getSheets().map(s => s.getName());
console.log(names);
実行ログに出た名前を、コードの名前とそのまま見比べてください。このように一覧のまま出すと、名前が引用符で囲まれて表示されるので、前後に入ったスペースも見分けられます。
再発を防ぐには、シートが見つからなかったときに、分かりやすいメッセージで止めるようにしておくと安心です。
if (!sheet) throw new Error('シート「売上」が見つかりません。名前が変わっていないか確認してください');
■ 原因2:スプレッドシートに紐づいていないスクリプトで getActiveSpreadsheet を使っている
スプレッドシートのメニューから作ったスクリプトではなく、Googleドライブから単独で作ったスクリプトの場合、getActiveSpreadsheet は「開いているスプレッドシート」が無いので null を返します。
直し方:スプレッドシートのIDを指定して開きます。
const ss = SpreadsheetApp.openById('スプレッドシートのID');
IDは、スプレッドシートのURLの「/d/」と「/edit」の間にある長い文字列です。
■ 原因3:取ってきた行やセルが、そもそも無い
例えば、検索した結果が見つからなかったときに null が返る関数があります。Gmailの検索や、フォームの回答、正規表現の match などです。
const m = text.match(/注文番号:(\d+)/);
const orderNo = m[1];
文章の中に「注文番号:」が無いと、match は null を返し、m[1] でエラーになります。
直し方:見つからなかったときの分かれ道を入れます。
const m = text.match(/注文番号:(\d+)/);
if (!m) { console.log('注文番号が見つかりませんでした'); return; }
const orderNo = m[1];
■ よく似たエラー:undefined の場合
「Cannot read properties of undefined (reading 'range')」のように、null ではなく undefined と出ることもあります。
よくあるのは、onEdit や onFormSubmit のように「編集されたとき」「フォームが送られたとき」に動く関数を、エディタの実行ボタンで直接動かした場合です。このとき、編集の情報(e)が渡されないので、e.range を読もうとしてエラーになります。
この種類の関数は、実際にシートを編集したり、フォームを送ったりして動かして確かめてください。
■ どこで止まっているかの見つけ方
エラーの表示には、止まった行の番号が出ます。その行で使っている変数を、一つ前の行で console.log に出してみてください。null や undefined と出たものが、取ってこられなかったものです。そこから、なぜ取ってこられなかったのかをさかのぼると、原因に早くたどり着けます。
■ 自分で直すのが難しいときは
「作った人がいなくて中身が分からない」「どの行を見ればいいか分からない」という場合は、エラーの表示と、どんな処理をしているかを教えていただければ、原因と直し方をお伝えします。同じエラーが二度と起きにくい形に整えることもできます。
納品後も月額で保守・改善を続けるご契約のご相談も受けています。納期や対応の頻度は柔軟にご相談ください。
GASのエラー修正のサービスはこちらです。