Flask调用flash()生成的闪现消息未在页面展示问题求助

排查步骤及解决方案 #

• 第一步：确认配置了SECRET_KEY
  Flask的闪现消息存储在session中，必须配置SECRET_KEY才能正常读写session，没有配置的话flash消息会直接丢失。
  在你的Flask启动文件中添加如下配置：

app = Flask(__name__)
# 密钥可以自定义任意字符串，生产环境注意不要泄露
app.secret_key = "你自定义的任意密钥内容"

• 第二步：确认flash代码实际被执行
  你当前的flash逻辑包裹在if sensible == 'Agreed' and accurate == 'Agreed'判断中，你可以在flash行前加打印日志，确认提交表单时这个条件是否触发、flash代码有没有被执行：

if sent:
    print("触发成功flash") # 加这行调试，看控制台有没有输出
    flash('Suggestion submitted successfully', category='success')
else:
    print("触发失败flash") # 加这行调试
    flash('Error submitting suggestion. Please try again later', category='error')

如果没输出，说明条件判断未通过，根本没有执行flash逻辑，需要排查senisble和accurate两个参数的取值是否符合预期。

• 第三步：确认重定向后的页面模板正确继承了base.html
  你把闪现消息渲染逻辑写在base.html中，需要确认url_for('suggest')对应的suggest视图渲染的模板，第一行有{% extends "base.html" %}的声明，否则base中的代码不会被加载到最终页面里。
  另外要注意：不要在项目其他位置提前调用get_flashed_messages()，这个方法调用一次后就会清空所有存储的闪现消息，后续再调用就会返回空列表。同时确认suggest视图中没有执行session.clear()之类清空session的操作，闪现消息存在session中，清空session会直接导致消息丢失。
• 第四步：修正模板中循环变量的顺序错误
  你调用get_flashed_messages(with_categories=true)时，返回的每个元素是(分类, 消息内容)的元组，你当前的循环顺序写反了，就算后面拿到消息也会导致分类判断失效，需要修改成：

{% for category, message in messages %} <!-- 把category放前面，message放后面 -->
    {% if category == 'success' %}
        <div class='message success'>
            <p>{{ message }}</p>
        </div>
    {% elif category == 'error' %}
        <div class='message error'>
            <p>{{ message }}</p>
        </div>
    {% endif %}
{% endfor %}

内容的提问来源于stack exchange，提问作者DillonB07