先生と生徒の会話形式で理解しよう

生徒

「先生、Flaskを始めたばかりなんですが、エラーがたくさん出て何がなんだか分かりません…」

先生

「大丈夫ですよ。Flaskではよくあるエラーがいくつかあるので、初心者でも原因と対処法を知っておけば怖くありません。」

生徒

「どんなエラーがあるんですか？解決の仕方も教えてください！」

先生

「それでは、Flaskでよくあるエラーとそのトラブルシューティング方法を詳しく見ていきましょう！」

1. Flaskアプリが起動しない：ImportError

Flaskアプリを実行しようとしたときに、次のようなエラーが出ることがあります。


ImportError: cannot import name 'Flask' from 'flask'

これは、Flaskが正しくインストールされていないか、ファイル名がflask.pyになっていて、自分自身を読み込もうとしてしまっていることが原因です。

ファイル名をapp.pyやmain.pyなどに変更してから、再度実行してみましょう。

2. ポートがすでに使われている：OSError

Flaskの開発サーバーを立ち上げたときに、以下のようなエラーが出ることがあります。


OSError: [Errno 98] Address already in use

これは、すでに同じポート番号（通常は5000番）でアプリが起動していることが原因です。前の実行プロセスが残っていることもあります。

ターミナルを一度閉じるか、以下のコマンドでポートを使用しているプロセスを終了させましょう。


lsof -i :5000
kill -9 プロセス番号

3. SyntaxError：文法ミスのエラー

Pythonの基本的な文法ミスで起きるエラーです。Flaskだけでなく、Python全体でよく起きます。


SyntaxError: invalid syntax

例えば、コロン:を忘れたり、インデントがずれていたりします。


def hello()
    print("こんにちは")  # ← コロンがないためエラー

コロンを追加すれば直ります。


def hello():
    print("こんにちは")

4. NameError：変数や関数が見つからない

次のようなエラーは、タイピングミスや定義漏れが原因です。


NameError: name 'app' is not defined

appが定義されていないのに使おうとしています。Flaskの基本的な構造では、最初にこのように書いてある必要があります。


from flask import Flask
app = Flask(__name__)

5. IndentationError：インデントのズレ

Pythonはインデント（行頭の空白）で処理のブロックを管理します。そのため、インデントのズレはエラーにつながります。


IndentationError: unexpected indent

例えば以下のように、行頭の空白が間違っている場合です。


def hello():
print("こんにちは")  # ← インデントが必要

正しくは次のように書きます。


def hello():
    print("こんにちは")

6. ModuleNotFoundError：モジュールが見つからない

Flaskをインポートするときに次のようなエラーが出たら、Flaskがまだインストールされていない可能性があります。


ModuleNotFoundError: No module named 'flask'

このエラーは、Flaskがパソコンにインストールされていないために起きます。以下のコマンドでFlaskをインストールしましょう。


pip install flask

7. TemplateNotFound：HTMLファイルが見つからない

Flaskでは、HTMLテンプレートを読み込むときに次のようなエラーが出ることがあります。


jinja2.exceptions.TemplateNotFound: index.html

Flaskは、HTMLファイルを必ずtemplatesという名前のフォルダの中に入れておく必要があります。

例えば、次のような構成になっていないと読み込めません。


project_folder/
│
├── app.py
└── templates/
    └── index.html

8. UnicodeDecodeError：日本語ファイルの読み込みエラー

日本語のテキストファイルを読み込もうとしたとき、以下のようなエラーが出ることがあります。


UnicodeDecodeError: 'utf-8' codec can't decode byte...

これはファイルの文字コード（文字の保存方法）が、FlaskやPythonが読み込める形式と合っていないことが原因です。

ファイルを開くときにエンコーディングを指定することで回避できます。


with open("data.txt", "r", encoding="utf-8") as f:
    content = f.read()

9. HTTP 404エラー：ページが見つからない

Flaskアプリを起動してブラウザでアクセスしたとき、404エラーになることがあります。

このエラーは、URLに対応するルートが定義されていないことが原因です。


@app.route("/")
def home():
    return "こんにちは！"

アクセスするURLが/でなければ、この関数は呼び出されません。ルート（道筋）を正しく定義することが大切です。

まとめ

Flaskを使った開発では、初心者がつまずきやすいエラーがいくつも存在し、それぞれが小さな理由によって発生するため、最初はとても混乱しやすく感じられます。とくに、環境構築の段階で起こるモジュールの読み込み失敗や、基本的な文法に関するエラーは、学習を始めたばかりの段階では理由が分かりにくいことが多く、その結果として「なぜ動かないのかわからない」という状況に陥りやすいものです。しかし、これらのエラーは原因と対処方法が明確で、ひとつひとつ丁寧に確認していくことで必ず解決できます。初心者が最初に理解しておくと役に立つポイントは、ファイル名やフォルダ構成の規則、文法の正確さ、インデントの扱い、モジュールのインストール状況、そしてルーティングの正しい設定など、Flaskに限らずPython全体に共通する基本的な部分に多く存在しています。また、エラーが発生したときに落ち着いて原因を読み解く習慣をつけることは、今後の学習においてとても大切です。Flaskのエラーメッセージは一見すると難しく見えますが、内容には必ずヒントが含まれており、どの部分が問題なのかを教えてくれています。例えば、ImportErrorであればどのモジュールが読み込めなかったかが示され、NameErrorであればどの変数が未定義なのかを知らせてくれます。テンプレートが見つからないエラーであれば、フォルダ構成の誤りを教えてくれますし、ポートの競合エラーであれば別のプロセスが動いていることを示してくれます。このように、エラーメッセージを正しく読み取ることで、解決までの道のりが格段に短くなります。さらに、Flaskのエラーを学ぶことで、アプリケーション開発に必要な基本的な仕組みも深く理解できるようになります。例えば、ルーティングの設定を理解することは、HTTPの仕組みやブラウザへの応答構造を学ぶきっかけにもなりますし、テンプレートのフォルダ位置に関する知識は、Webフレームワークのディレクトリ構造やテンプレートエンジンの理解につながります。文字コードに関するエラーを理解することは、ファイルの読み書きや国際化対応にもつながります。つまり、今回のような代表的なエラーを知っておくことで、単なるエラー解決だけではなく、Webアプリケーション開発に必要な基本的な知識を広く身につけることができるのです。また、エラーを修正する際にコードを少しずつ確認する習慣をつけると、学習の効率が大きく向上します。例えば、わずかなインデントのずれで動かないことに気づいたとき、Pythonがどのようにコードを読み取っているのかを理解するきっかけになりますし、Flaskの構成が正しくないときにディレクトリを見直す習慣は、プロジェクトが大きくなったときにも大きな助けになります。こうした積み重ねによって、自然とエラーを予防できるようになり、さらに応用的なコードも書けるようになっていきます。初心者のうちは「正しく書いているつもりなのに動かない」という状況が頻繁に起こりますが、そのたびに基本を振り返ることで理解が深まり、確実に成長につながります。今回学んだ代表的なエラーは、Flaskだけでなく他のフレームワークを学ぶ際にも役に立つ知識ばかりです。ぜひ、エラーを恐れず、一つずつ丁寧に確認する習慣を身につけてください。

サンプルコード：基本的なFlaskアプリの正しい構成


from flask import Flask, render_template

app = Flask(__name__)

@app.route("/")
def index():
    return render_template("index.html")

if __name__ == "__main__":
    app.run(debug=True)

先生と生徒の振り返り会話

生徒

「先生、今回のエラーの勉強でFlaskの仕組みがよく分かってきました。特にテンプレートの場所やルーティングの設定がとても重要だということが印象に残りました。」

先生

「その気づきはとても大切ですよ。Flaskでは小さな設定の違いが大きなエラーにつながるので、一つずつ丁寧に確認する習慣が今後の成長につながります。」

生徒

「エラーメッセージを読むのも大切ですね。最初は怖かったですが、どこが問題なのか分かるようになってきました！」

先生

「その調子です。エラーは学ぶきっかけなので、これからも積極的に読み解いていきましょう。」