Flask-debugtoolbarを入れたらエラー発生

Question

実現したいこと

ここに実現したいことを箇条書きで書いてください。

• flask runでアプリ起動

前提

『Python FlaskによるWebアプリ開発入門』を読み進めています。
flask-debugtoolbarをインストール後（本書p67）にflask runすると、以下のエラーメッセージが発生しました。

解消法が分かる方はいらっしゃいますでしょうか？><

発生している問題・エラーメッセージ

Error: While importing 'apps.minimalapp.app', an ImportError was raised:

Traceback (most recent call last):
  File "/Users/xxxxx/flaskbook/venv/lib/python3.12/site-packages/flask/cli.py", line 219, in locate_app
    __import__(module_name)
  File "/Users/xxxxx/flaskbook/apps/minimalapp/app.py", line 13, in <module>
    from flask_debugtoolbar import DebugToolbarExtension
  File "/Users/xxxxx/flaskbook/venv/lib/python3.12/site-packages/flask_debugtoolbar/__init__.py", line 5, in <module>
    from flask.globals import _request_ctx_stack
ImportError: cannot import name '_request_ctx_stack' from 'flask.globals' (/Users/xxxxx/flaskbook/venv/lib/python3.12/site-packages/flask/globals.py)

ソースコード

import logging
from email_validator import validate_email, EmailNotValidError
from flask import (
    Flask,
    render_template,
    url_for,
    current_app,
    g,
    request,
    redirect,
    flash
)
from flask_debugtoolbar import DebugToolbarExtension

app = Flask(__name__)
app.config["SECRET_KEY"] = "2AZSMss3p5QPbcY2hBsJ"
app.logger.setLevel(logging.DEBUG)
app.config["DEBUG_TB_INTERCEPT_REDIRECTS"] = False
toolbar = DebugToolbarExtension(app)


@app.route("/")
def index():
    return "Hello, Flaskbook!"


@app.route("/hello/<name>", methods=["GET", "POST"], endpoint="hello-endpoint")
def hello(name):
    return f"Hello, {name}!"


@app.route("/name/<name>")
def show_name(name):
    return render_template("index.html", name=name)


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


@app.route("/contact/complete", methods=["GET", "POST"])
def contact_complete():
    if request.method == "POST":
        username = request.form["username"]
        email = request.form["email"]
        description = request.form["description"]

        is_valid = True

        if not username:
            flash("ユーザ名は必須です")
            is_valid = False

        if not email:
            flash("メールアドレスは必須です")
            is_valid = False

        try:
            validate_email(email)
        except EmailNotValidError:
            flash("メールアドレスの形式で入力してください")
            is_valid = False

        if not description:
            flash("問い合わせ内容は必須です")
            is_valid = False

        if not is_valid:
            return redirect(url_for("contact"))

        # メールを送る（最後に実装）

        flash("問い合わせ内容はメールにて送信されました。問い合わせありがとうございます。")
        return redirect(url_for("contact_complete"))

    return render_template("contact_complete.html")


with app.test_request_context():
    # /
    print(url_for("index"))
    # /hello/world
    print(url_for("hello-endpoint", name="world"))
    # /name/ichiro?page=1
    print(url_for("show_name", name="ichiro", page=1))


with app.test_request_context("/users?updated=true"):
    print(request.args.get("updated"))

補足情報（FW/ツールのバージョンなど）

Name: Flask
Version: 3.0.0
Summary: A simple framework for building complex web applications.
Home-page: 
Author: 
Author-email: 
License: 
Location: /Users/yasu/flaskbook/venv/lib/python3.12/site-packages
Requires: blinker, click, itsdangerous, Jinja2, Werkzeug
Required-by: Flask-DebugToolbar

Name: Flask-DebugToolbar
Version: 0.13.1
Summary: A toolbar overlay for debugging Flask applications.
Home-page: https://github.com/flask-debugtoolbar/flask-debugtoolbar
Author: Michael van Tellingen
Author-email: [e-mail]
License: UNKNOWN
Location: /Users/yasu/flaskbook/venv/lib/python3.12/site-packages
Requires: Blinker, Flask, itsdangerous, werkzeug
Required-by: 

Answer 1

Flask-DebugToolbar は Flask Ver3.0.x以上では動作しないようです。

動かしたいだけなら、以下を実行すると動かせます。

1. Flaskをversion 2.3.3を指定してインストールする(pip install Flask==2.3.3)
   Flaskがインストールされている場合は、新しいvenvを作成するか、全部消してから実行してください。
   (全部: Flaskをインストールすると、clickとか、jinja2とかが勝手に入るので、削除してください。面倒なので、venv作り直すのが楽です。)
2. 2.3.3を指定してインストールすると、Werkzeug==3.0.1がインストールされ、動いてくれないので、一旦Werkzeugをアンインストールする(pip uninstall werkzeug)
3. Flask==2.3.3で動作するwerkzeugをインストールする(pip install werkzeug==2.3.7)
4. Flask-DebugToolbarをインストールする( pip install flask-debugtoolbar)

動作したサンプルも置いておきます。

app.py

from flask import Flask, render_template
from flask_debugtoolbar import DebugToolbarExtension

app = Flask(__name__)

app.debug = True
app.config['SECRET_KEY'] = '<replace with a secret key>'

toolbar = DebugToolbarExtension(app)


@app.route('/')
def hello_world():  # put application's code here
    return render_template('index.html')


if __name__ == '__main__':
    app.run()

templates/index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
sample
</body>
</html>

Comments

[yasuuu]

ありがとうございます。
flask2.3.3をインストールし、上記の手順をやったところ、動きました！