Flask收发JSON场景下替代flash('Helpful Message')的惯用写法是什么？

flash消息本质是存储在用户session中的临时消息，常规页面渲染时由Jinja2模板取出消费，JSON接口场景下只需要调整消息的消费逻辑即可，完全可以复用原有flash调用习惯，不需要额外造轮子。

服务端实现 #

你可以选择两种方式处理，均不需要修改原有flash()的调用逻辑：

1. 单接口手动处理
   适合JSON接口数量较少的场景，直接在构造响应时取出flash消息塞入JSON字段即可：

from flask import jsonify, get_flashed_messages

@main.route('/api/update-details', methods=['POST'])
def update_details():
    # 原有业务逻辑不变
    if is_invalid():
        flash('Invalid')
    if operation_success():
        flash('更新成功')
    
    # 新增：取出所有未消费的flash消息
    flash_messages = get_flashed_messages()
    return jsonify({
        "code": 0,
        "data": {}, # 这里放你的业务返回数据
        "flashes": flash_messages
    })

2. 全局自动注入
   适合JSON接口数量较多的场景，通过after_request钩子自动给所有JSON响应注入flash消息，不需要每个接口单独处理：

import json
from flask import get_flashed_messages

@app.after_request
def inject_flash_to_json(response):
    # 仅处理JSON类型的响应
    if response.is_json:
        resp_data = response.get_json()
        # 注入flash消息到固定字段
        resp_data["flashes"] = get_flashed_messages()
        response.set_data(json.dumps(resp_data))
    return response

如果你的flash使用了分类（比如flash('错误提示', 'error')），只需要把get_flashed_messages()替换为get_flashed_messages(with_categories=True)，返回[分类, 消息]的二维数组即可，和Jinja2模板中的用法完全一致。

前端实现 #

只需要在JSON响应回调中，把拿到的flash消息渲染到原有页面的flash容器中即可，完全复用原有样式规则，不需要额外写样式逻辑：

// 对应你base.html中放flash消息的父容器选择器
const flashWrapper = document.querySelector('.flash-container')

// 以fetch请求为例
fetch('/api/update-details', {
    method: 'POST',
    body: yourFormData
}).then(res => res.json()).then(res => {
    // 先清空旧消息
    flashWrapper.innerHTML = ''
    // 渲染新的flash消息，结构和Jinja2生成的完全一致
    res.flashes.forEach(message => {
        const msgNode = document.createElement('div')
        msgNode.textContent = message
        flashWrapper.appendChild(msgNode)
    })
    // 原有局部更新页面的业务逻辑不变
})

如果使用了带分类的flash，渲染时给消息节点加上对应分类的类名即可，和Jinja2的渲染逻辑完全对齐。

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