表計算お助けツール&ノウハウ

古いGAS/マクロが動かなくなった時の直し方

困っていること

数年前に作った(または作ってもらった)GASやExcelマクロが、ある日突然動かなくなった。作った人はもういない、ドキュメントもない。「旧スクリプトの修正」は、実務で根強くある相談です。慌ててコードを書き換える前に、切り分けの順序を決めることが大切です。

手順(切り分けの順序)

1. まずバックアップを取る

何をするにも先に、現状のファイル(スクリプトを含むブック/スプレッドシート全体)をコピーして保管してください。修正作業そのもので壊してしまう事故を防ぐためです。GASはスクリプトエディタのバージョン履歴も併せて確認しておきます。

2. エラーメッセージを確認する

エラー文はそのまま控えてください。「なんとなく動かない」から「この行で、このエラーで止まる」に変わるだけで、対処の精度が大きく上がります。

3. 「いつから」「何が変わったか」を並べる

長く動いていたものが止まる場合、原因はコード自体より「周りの変化」であることが多いです。次のような変化がなかったか確認してください。

4. GAS特有:ランタイムと仕様変更を確認する

GASは現在の標準ランタイムがV8です。古いRhinoランタイム時代に書かれたコードには、V8では動かない書き方が含まれている場合があり、公式の移行ガイドが用意されています。また、ライブラリや外部サービスの仕様変更で、同じコードでも結果が変わることがあります。エラー文にサービス名やメソッド名が含まれていれば、公式リファレンスで現行の仕様を確認してください。

5. Excelマクロ特有:形式と参照設定を確認する

6. 最小再現で直す範囲を絞る

全体を一度に直そうとせず、エラーが出る処理だけを小さなテストで再現し、直ったら少しずつ戻します。直した箇所には、日付と変更内容をコメントで残してください。次に止まった時の切り分けが速くなります。

注意点

参照:Google Apps Script 公式ドキュメント(V8ランタイム移行ガイド、実行ログ)、Microsoft サポート(マクロ有効ブック、参照設定)。

自動化のご相談

「毎週の転記・集計をなくしたい」「CSVの整形を自動化したい」「古いGASを直したい」といったご相談を承っています。1ファイル・1処理の小さな作業から対応し、作業前に必ずメッセージで内容を確認して、対応範囲と金額を先にお伝えします。検証記録と手順書付きで納品します。

相談してみる(Coconala)

※出品ページは準備中です。公開まではこのボタンは仮のリンクです。