flash()是Flask提供的一个非常有用的功能，用于在请求之间存储临时消息（通常用于用户反馈），这些消息可以在下一个请求中显示。

基本概念 #

Flash消息系统允许你在一个请求中存储消息，然后在下一个（且仅下一个）请求中访问这些消息。这非常适合用于重定向后的用户反馈场景。

基本用法 #

1. 设置flash消息 #

from flask import Flask, flash, redirect, url_for

app = Flask(__name__)
app.secret_key = 'your-secret-key'  # 必须设置密钥才能使用session

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        # 验证逻辑...
        if login_failed:
            flash('Invalid username or password', 'error')
            return redirect(url_for('login'))
        flash('You were successfully logged in', 'success')
        return redirect(url_for('dashboard'))
    return render_template('login.html')

2. 在模板中显示flash消息 #

在模板中（通常放在base.html中）：

<!-- 在Jinja2模板中 -->
{% with messages = get_flashed_messages() %}
  {% if messages %}
    <ul class="flashes">
    {% for message in messages %}
      <li>{{ message }}</li>
    {% endfor %}
    </ul>
  {% endif %}
{% endwith %}

高级用法 #

1. 分类flash消息 #

可以为flash消息指定类别，然后在模板中按类别处理：

flash('Login successful', 'success')
flash('Warning: something happened', 'warning')
flash('Error occurred', 'error')

在模板中按类别显示：

{% with messages = get_flashed_messages(with_categories=true) %}
  {% if messages %}
    {% for category, message in messages %}
      <div class="alert alert-{{ category }}">{{ message }}</div>
    {% endfor %}
  {% endif %}
{% endwith %}

2. 使用CSS样式 #

可以为不同类别的消息添加不同的样式：

.alert-success {
    color: green;
    background-color: #dff0d8;
}
.alert-warning {
    color: #8a6d3b;
    background-color: #fcf8e3;
}
.alert-error {
    color: #a94442;
    background-color: #f2dede;
}

3. 过滤特定类别的消息 #

# 只获取'success'类别的消息
success_messages = get_flashed_messages(category_filter=['success'])

实现原理 #

Flash消息系统基于Flask的session机制实现：

1. 调用flash()时，消息被存储在session中
2. 调用get_flashed_messages()时，消息被取出并从session中删除
3. 因此，消息只能被获取一次

注意事项 #

1. 必须设置secret_key：因为flash依赖于session，所以必须配置app.secret_key
2. 消息只显示一次：消息被获取后会自动清除
3. 重定向场景：通常在重定向前设置flash消息，在重定向后的页面显示
4. 消息大小限制：由于存储在cookie中，消息不宜过大
5. HTML安全：如果消息内容来自用户输入，应该进行转义防止XSS攻击

实际应用示例 #

@app.route('/add_item', methods=['POST'])
def add_item():
    try:
        # 添加项目逻辑...
        flash('Item added successfully', 'success')
    except Exception as e:
        flash(f'Error adding item: {str(e)}', 'error')
    return redirect(url_for('item_list'))

Flash消息系统是Flask中实现用户反馈的一种简洁有效的方式，特别适合在表单提交、登录登出等操作后向用户提供反馈信息。