Flask-Session und Cookie

Das HTTP-Protokoll selbst ist zustandslos – der Server merkt sich nicht automatisch, ob zwei Anfragen vom selben Benutzer stammen.

Flask überSessionDer Mechanismus löst dieses Problem und ermöglicht es Webanwendungen, den Benutzerstatus zu "erinnern".


Wie Session funktioniert

Flask verwendet standardmäßigSecureCookieSession, und die Funktionsweise ist:

  • Session-Daten werden serialisiert, mit einem Schlüssel signiert und im Cookie des Browsers gespeichert.
  • Bei jeder Anfrage sendet der Browser dieses Cookie automatisch mit.
  • Nachdem Flask die Signatur überprüft hat, stellt es die Daten als Python-Dictionary wieder her, damit du sie verwenden kannst.

Benutzer können den Inhalt im Cookie sehen (da er base64-kodiert ist), aber sie können ihn nicht manipulieren – denn jede Änderung führt dazu, dass die Signaturüberprüfung fehlschlägt.

Session 签名 Cookie 工作机制


SECRET_KEY konfigurieren

Um Session zu verwenden, musst du zuerst einen geheimen Schlüssel festlegen.SECRET_KEY– der geheime Schlüssel, der zum Signieren verwendet wird.

Beispiel

import secrets
from flask import Flask

app = Flask(__name__)

# Erzeuge einen sicheren zufälligen Schlüssel (muss nur beim ersten Ausführen generiert werden)
# secrets.token_hex() erzeugt eine 64-stellige hexadezimale Zufallszeichenkette
app.secret_key = secrets.token_hex()
# Oder direkt einen festen Wert setzen (praktisch für die Entwicklung, aber nicht in der Produktion verwenden)
# app.secret_key = "dev-secret-key-change-in-production"

Wichtig:SECRET_KEYEr muss geheim gehalten werden und ausreichend zufällig sein. Wenn der Schlüssel leckt, kann jeder die Session-Daten Ihrer Anwendung fälschen. In der Produktion lesen Sie ihn aus Umgebungsvariablen oder Konfigurationsdateien—hardcodieren Sie ihn nicht im Code.

Befehl zum Generieren eines hochwertigen Schlüssels:

$ python -c 'import secrets; print(secrets.token_hex())'
192b9bdd22ab9ed4d12e236c78afcb9a393ec15f71bbf5dc987d54727823bcbf

Session lesen und schreiben

sessionEs ist ein dictionary-ähnliches Objekt und wird im Grunde genauso verwendet wie ein Python-Dictionary:

Beispiel

from flask import Flask, session, redirect, url_for, request

app = Flask(__name__)
app.secret_key = "dev-secret-key"

@app.route("/")
def index():
    # Prüfen, ob die Session username enthält
    if "username" in session:
        return f"""
<h1>Willkommen zurück, {session["username"]}!</h1>
<p>Ihre Besuchszahl: {session.get("visits", 0)}</p>
<p><a href="/logout">Abmelden</a></p>
        """


    return """
<h1>BEISPIEL Startseite</h1>
<p>Du bist noch nicht angemeldet.</p>
<p><a href="/login">Zum Login gehen</a></p>
    """


@app.route("/login", methods=["GET", "POST"])
def login():
    if request.method == "POST":
        username = request.form.get("username", "")
        if username:
            # Den Benutzernamen in der Session speichern
            session["username"] = username
            # Besuchszähler initialisieren
            session["visits"] = 0
            return redirect(url_for("index"))

    return """
    <form method="post">
<h2>Bei EXAMPLE anmelden</h2>
<p><input type="text" name="username" placeholder="Benutzername eingeben"></p>
<p><input type="submit" value="Anmelden"></p>
    </form>
    """


@app.route("/logout")
def logout():
    # Alle Daten in der Session löschen
    session.clear()
    # Oder nur einen bestimmten Schlüssel löschen:
    # session.pop("username", None)
    return redirect(url_for("index"))

Permanente Session

Standardmäßig wird die Session ungültig, nachdem der Browser geschlossen wurde (Browser-Session-Ebene).

Wenn Sie eine "Remember Me"-Funktion benötigen, können Sie die Session als permanent markieren.Permanent (permanent):

Beispiel

from datetime import timedelta

# Gültigkeitsdauer der permanenten Session festlegen (Standard: 31 Tage)
app.config["PERMANENT_SESSION_LIFETIME"] = timedelta(days=7)

@app.post("/login-remember")
def login_remember():
    username = request.form.get("username")
    if username:
        session["username"] = username
        # Als permanente Session markieren, bleibt auch nach Schließen des Browsers gültig
        session.permanent = True
        return redirect(url_for("index"))

Message Flashing——Einmalige Nachrichten

Nachdem der Benutzer das Formular abgesendet hat, müssen Rückmeldungen wie "Vorgang erfolgreich" oder "Fehler" angezeigt werden.

Für diese Art von Nachricht, die "nach einmaliger Anzeige verschwindet", bietet Flask Flash-Nachrichten.flash()Mechanismus.

Beispiel

from flask import Flask, flash, get_flashed_messages, redirect, render_template, request, url_for

app = Flask(__name__)
app.secret_key = "dev-secret-key"

@app.route("/post", methods=["GET", "POST"])
def create_post():
    if request.method == "POST":
        title = request.form.get("title", "").strip()

        if not title:
            # Fehlermeldung in Flash speichern, kategorisiert als "error"
            flash("Titel darf nicht leer sein", "error")
            return redirect(url_for("create_post"))

        # Erfolgsmeldung in Flash speichern, kategorisiert als "success"
        flash(f"Artikel '{title}' erfolgreich veröffentlicht!", "success")
        return redirect(url_for("create_post"))

    return render_template("create_post.html")

@app.route("/flash-demo")
def flash_demo():
    # Alle Flash-Nachrichten abrufen (werden nach dem Lesen automatisch gelöscht)
    messages = get_flashed_messages(with_categories=True)
    return render_template("flash_demo.html", messages=messages)

Flash-Nachrichten in Templates rendern:

Beispiel

<!-- Dateipfad: templates/create_post.html -->
<!DOCTYPE html>
<html>
<head>
    <title>Artikel veröffentlichen - BEISPIEL</title>
    <style>
        .flash-success { color: green; background: #E8EEF5; padding: 10px; border-radius: 4px; }
        .flash-error { color: red; background: #ffebee; padding: 10px; border-radius: 4px; }
        .flash-info { color: blue; background: #e3f2fd; padding: 10px; border-radius: 4px; }
    </style>
</head>
<body>
    <h1>Artikel veröffentlichen</h1>

    <!-- Alle Flash-Nachrichten abrufen und anzeigen -->
    {% with messages = get_flashed_messages(with_categories=true) %}
        {% if messages %}
            {% for category, message in messages %}
                <div class="flash-{{ category }}">{{ message }}</div>
            {% endfor %}
        {% endif %}
    {% endwith %}

    <form method="post">
        <p>Titel:<input type="text" name="title" style="width:300px;"></p>
        <p><input type="submit" value="Veröffentlichen"></p>
    </Form>
</body>
</html>
Kategorie Empfohlene Anwendungsfälle
"message" (Standard) Allgemeine Benachrichtigung
"success" Vorgang erfolgreich
"error" Vorgang fehlgeschlagen
"warning" Warnmeldung
"info" Allgemeine Informationen

Flash-Nachrichten basieren auf Session, daher müssen Sie einen geheimen Schlüssel festlegen.SECRET_KEYErst dann kann sie verwendet werden.


Session-FAQ

Cookie-GrößenbeschränkungHinweis: Browser beschränken ein einzelnes Cookie auf etwa 4KB. Speichern Sie keine großen Datenmengen in Session – sie eignet sich für leichtgewichtige Informationen wie Benutzer-IDs und Einstellungen, nicht für Dateien oder große Objekte.

Weitere Erweiterungen