【2026年6月】shopify app devが急に「Validation errors in shopify.app.toml」で落ちる原因と対処｜Shopify CLI 4.2.0で解決 | Blog | RYX

はじめに

このような方のための記事です。

2026年6月19日頃から、Shopifyアプリ開発者の間でこのエラーが一斉に発生しました。

結論から言うと、原因は自分のコードではなくShopify側の変更で、対処はShopify CLIを4.2.0以上に上げるだけです。

何が起きたのか、なぜ起きたのか、どう直すのかを、開発者コミュニティの報告をもとに整理します。

npm run dev（shopify app dev）を実行すると、次のエラーで停止します。

App configuration is not valid
Validation errors in shopify.app.toml:
• [definitions]: Required

特徴は「自分は何も変えていない」点です。

昨日まで問題なく動いていたプロジェクトが、tomlを1行も触っていないのに突然落ちます。

報告者の検証では、npm init -y と標準的な shopify.app.toml だけのまっさらなディレクトリでも再現し、特定のプロジェクト固有の問題ではないことがわかっています。

エラーは「definitionsが必須」と言ってきますが、これに従って [definitions] を手書きで足すのは間違いです。

原因はShopify側のバリデーション変更にあります。

複数の開発者が、CLI 3.84系から3.92系までの幅広いバージョンで、ローカルを一切変更していないのに同時に再現することを確認しています。

verboseログには、プロジェクトに拡張機能が一つも無いのに「tax_calculation のスペックがローカルにあるがリモートに無い」という不一致が出ます。古いCLIがShopify側の最新仕様に追従できず、誤って [definitions] を必須と判定しているのが実態です。

エラー文に釣られて [definitions] を手で足すと、バリデーションは通りますが今度はdeployが壊れます。

Shopifyがその値を別の設定（order_attribution_config）と解釈し、さらに別の必須項目を要求してくるためです。この回避策は使わないでください。app.tomlの正式なフィールド仕様は公式ドキュメントにまとまっています。

確実な対処は、Shopify CLIを4.2.0以上に更新することです。

npm install -g @shopify/cli@latest

更新後、バージョンを確認します。

shopify version

Shopify側（コミュニティのスタッフ回答）も4.2.0での解消を確認しており、報告者の多くが更新後に直ったと報告しています。

Shopify CLIは4.0以降でSemVerと自動アップデートが導入されているため、同種の問題を踏みにくくする意味でも最新へ上げておくのが安全です。

詳しくは Shopify CLI 4.0の変更点まとめも参考にしてください。

4.2.0に上げても解消しないという報告も一部あります。その場合は、CLIのキャッシュと設定を削除してから再実行してください。

rm -rf ~/.cache/shopify
rm -rf ~/.config/shopify

これで認証情報やキャッシュがリセットされ、解消したケースが報告されています。

削除後は認証のやり直しが必要になります。

業務で今すぐ動かす必要がある場合の緊急回避として、3.93.0など問題が出ない旧バージョンに固定する手もあります。

ただし旧バージョンはOAuthまわりの挙動が変わることがあるため、基本は4.2.0以上への更新を推奨します。

このエラーは自分のコードのミスではなく、Shopify側の変更が引き金です。[definitions] を手書きで足す前に、まずShopify CLIを4.2.0以上へ更新してください。それでも直らなければ、キャッシュと設定の削除を試す。この順番が最短です。

Shopifyアプリ開発やCLIまわりのトラブル対応については、お問い合わせからお気軽にご相談ください。