はじめに
Flutterの開発を進めていると、必ずと言っていいほど「赤い画面」や「謎のエラーメッセージ」に遭遇します。
「英語ばかりで何が書いてあるか分からない…」と絶望する必要はありません。実は、初心者が遭遇するエラーの多くは決まったパターンです。本記事では、2026年最新のFlutter開発で特によく見るエラー10選とその解決策を、初心者の方にも分かりやすく解説します。
1. ビルドが通らない・動かない時の共通対策
個別のエラーを見る前に、まずはこの「魔法のコマンド」を試しましょう。
Bash
flutter clean
flutter pub get
多くの謎エラーは、古いキャッシュが原因で起こります。
2. よくあるエラーと解決策10選
各エラーを「何が起きたか」という日本語の見出しに整理しました。
✅ ① パッケージが読み込めない
エラー文： Target of URI doesn't exist...
- 原因： ライブラリを追加した直後などで、エディタが認識できていない。
- 解決： ターミナルで
flutter pub getを実行。直らなければエディタ（VS Code）を再起動。
✅ ② 「空っぽ」のデータでアプリが止まる
エラー文： A value of type 'Null' can't be assigned...
- 原因： Null Safety違反。中身が空（null）になる可能性がある変数に、空を許さない型を指定している。
- 解決： 型の末尾に
?を付けてString?にするか、?? '初期値'で空の時の値を指定する。
✅ ③ 画面の高さが無限になってエラー
エラー文： Vertical viewport was given unbounded height
- 原因：
Columnの中にListViewを入れると、高さの計算ができなくなる。 - 解決：
ListViewをExpandedウィジェットで囲む。
✅ ④ データが空なのにアクセスしようとした
エラー文： The method '[]' was called on null
- 原因： リストやマップの中身が空の状態なのに、データを取り出そうとした。
- 解決：
if (data != null)などで、データが存在することを確認してから処理する。
✅ ⑤ iOSのビルドツールが古い (Mac)
エラー文： CocoaPods not installed or installed version too old
- 原因： iPhoneアプリ作成に必要な「CocoaPods」が未設定。
- 解決： ターミナルで
sudo gem install cocoapodsを実行。
✅ ⑥ Androidの規約に同意していない
エラー文： Android license status unknown
- 原因： Googleのライセンス条項に未同意。
- 解決：
flutter doctor --android-licensesを打ち、すべてyで答える。
✅ ⑦ 前の処理が残っていて動かない
エラー文： Waiting for another flutter command...
- 原因： 前のコマンドが裏でフリーズして「ロック」をかけている。
- 解決：
flutter/bin/cache/lockfileというファイルを削除するか、PC再起動。
✅ ⑧ 画像が表示されない
エラー文： Asset not found
- 原因：
pubspec.yamlの記述ミス、または画像のファイルパスが違う。 - 解決：
pubspec.yamlの**インデント（半角スペース2つ）**が正しいか確認。
✅ ⑨ 画面からボタンなどがはみ出している
エラー文： Bottom overflowed by XXX pixels
- 原因： 画面サイズに対してコンテンツが多すぎる。
- 解決： 全体を
SingleChildScrollViewで囲んでスクロール可能にする。
✅ ⑩ 画面の土台（Scaffold）がない
エラー文： No Material widget found
- 原因： ボタンなどの部品を使っているのに、土台となる
ScaffoldやMaterialAppがない。 - 解決： ウィジェットの最上位に
Scaffoldを配置する。
3. まとめ：エラーは怖くない！
エラーメッセージは「ここが間違っているよ」と教えてくれるガイドです。2026年現在はAI（ChatGPTやGemini）にエラー文を貼り付けるだけで、より詳細なアドバイスももらえます。