Flask学習｜エラーハンドリングの基本を学ぼう【チャプター6-02】

一つ前のページではFlaskでよくあるエラー集と対処法について学習しました。

今回は エラーハンドリングの基本 について見ていきましょう。

Webアプリを開発していると、予期せぬエラーに遭遇することは避けられません。

エラーを適切に処理し、ユーザーに分かりやすく伝える仕組みは、アプリの品質と信頼性を大きく左右します。

この記事では、Flaskでの開発時に役立つ エラーハンドリングの基本 について学びます。

<<前のページ

Flaskの記事一覧

次のページ>>

Flaskのエラーハンドリングとは？初心者向けに概要を解説

Flaskアプリケーションでは、ユーザーからの入力が不適切だったり、ファイルが見つからなかったりする場面でエラーが発生します。

こうしたエラーをそのまま放置するとアプリがクラッシュしたり、ユーザーに意味のわからないエラーメッセージが表示されてしまいます。

エラーの種類に応じた適切な対応を実装することで、アプリの安定性とユーザー体験を大幅に向上させることができます。

【復習】Pythonのtry/except構文とは？

Flaskに限らず、Pythonではエラーが起きそうな処理を「try」ブロックに書き、問題が発生した場合の処理を「except」ブロックに書くことができます。

基本構文は以下の通りです。

try:
    # エラーが起きそうな処理
except エラーの種類:
    # エラーが起きた時の処理

この構文により、プログラムを止めずにエラーへ柔軟に対応することが可能です。

Flaskでも内部的にはこの構文が利用されており、後述するabort()やerrorhandler()と連携して活用できます。

Pythonの例外処理について詳しく復習したい方は↓↓の記事を参考にしてください。

あわせて読みたい

【レッスン2-9】エラーに強いコードを書く！例外処理（try-except）の使い方｜Python入門

abort()関数を使ってHTTPエラーを返す方法

Flaskでは、HTTPリクエストに対してエラーを返したいときに abort() 関数 を使います。

例えば、ある条件を満たさない場合にリクエストを打ち切って「404 Not Found」や「403 Forbidden」などを返すといった用途です。

abort関数の書き方と使用例

基本構文は以下の通りです。

from flask import abort

abort(ステータスコード)

使用例は以下の通りです。

from flask import Flask, abort
app = Flask(__name__)

@app.route('/admin')      # もしこのURLにアクセスされたら（ルーティング）
def admin():
    user_is_admin = False # 仮の条件
    if not user_is_admin:
        abort(403)        # アクセス拒否
    return '管理者ページへようこそ'

よく使うHTTPステータスコード一覧

あわせて読みたい

Flask入門｜ルーティングを理解しよう【チャプター1-04】

app.errorhandler()でカスタムエラーメッセージを作ろう

特定のエラーが発生した際に、ユーザーに分かりやすい応答を返すための方法として、@app.errorhandler() デコレータ を用いたエラーハンドラの登録が可能です。

デコレーターについて復習したい方は↓↓の記事を参考にしてください。

あわせて読みたい

【レッスンF-2】デコレーターとは？関数をより柔軟に扱うテクニック｜Python学習

errorhandlerの定義方法と実装例

基本構文は以下の通りです。

@app.errorhandler(ステータスコード)
def ハンドラ関数名(error):
    return 'メッセージやテンプレートなど'

404エラー時にカスタムメッセージを返す例は以下の通りです。

from flask import Flask
app = Flask(__name__)

@app.errorhandler(404)
def page_not_found(error):
    return 'お探しのページは見つかりませんでした。', 404

このようにすることで、標準的なエラーページではなく、オリジナルのエラー応答を返すことができます。

テンプレートを使えば、視覚的にわかりやすいページを作ることもできます（詳細は次章で扱います）。

まとめ｜Flaskの基本エラーハンドリング手法を振り返ろう

この記事では、Flaskにおける基本的なエラーハンドリング手法を学びました。

エラー処理を制御できるようになると、アプリの完成度が一段とアップします。

次は、よりユーザーフレンドリーな「カスタムエラーページ」の作成にチャレンジしてみましょう！

<<前のページ

Flaskの記事一覧

次のページ>>

FAQ｜Flaskの基本的なエラーハンドリングについて