GASの「Cannot read properties of null」の原因と直し方

GASの「Cannot read properties of null」の原因と直し方

記事
IT・テクノロジー
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のエラー修正のサービスはこちらです。
サービス数100万件のスキルマーケット、あなたにぴったりのサービスを探す