Flask Server-Sent Events怎么写_SSE向浏览器主动推送实时数据

小浩同学_2213

小浩同学_2213

2026-04-07

823人浏览

原创

flask实现sse需用yield返回生成器,设content-type: text/event-stream和cache-control: no-cache,每条消息末尾双换行;前端用eventsource监听onmessage/onerror并手动重连;生产环境必须用异步服务器如uvicorn或gunicorn+gevent。

flask server-sent events怎么写_sse向浏览器主动推送实时数据

Flask 怎么写 SSE 路由

Flask 本身不内置 SSE 支持,但靠 yield + 正确的响应头就能实现。核心是返回一个生成器(generator),每条数据以 data: ...\n\n 格式输出,并设好 Content-Type: text/event-stream 和禁用缓存。

常见错误是直接 return 字符串、忘了加双换行、或没设 Cache-Control: no-cache —— 浏览器会等缓冲填满才吐数据,导致“一直没反应”。

  • 路由必须用 @app.route,不能用 @app.get(老版本 Flask 不识别)
  • 函数返回值必须是生成器函数(含 yield),不能是普通字符串或列表
  • 每条消息末尾必须有两个换行:yield "data: hello\n\n",少一个就解析失败
  • 推荐加 response.headers["Cache-Control"] = "no-cache",避免 Nginx 或浏览器缓存住流
from flask import Flask, Response
import time

app = Flask(__name__)

@app.route('/sse')
def sse():
    def event_stream():
        for i in range(5):
            yield f"data: message {i}\n\n"
            time.sleep(1)
    return Response(event_stream(), content_type='text/event-stream')

前端怎么连上 Flask SSE 并处理断线重连

EventSource 是浏览器原生 API,简单可靠,但默认不自动重连 —— 断网、服务重启后它就停了,用户得刷新页面。这不是 bug,是规范行为。

容易踩的坑:没监听 error 事件、把 onmessage 写成 addEventListener('message', ...)(漏掉 on 前缀)、或在 onerror 里直接 new EventSource(...) 导致无限新建连接。

  • 必须监听 onerror,并在其中检查 event.target.readyState 是否为 0(关闭状态)再重建
  • 重连前建议加延迟(如 setTimeout),避免雪崩请求
  • 如果后端返回自定义事件类型(如 event: update\n),前端要用 addEventListener('update', ...) 接,不是 onmessage
  • 记得调用 eventSource.close() 清理,比如组件卸载时
let es = null;
function connect() {
  es = new EventSource('/sse');
  es.onmessage = e => console.log('data:', e.data);
  es.onerror = () => {
    if (es && es.readyState === 0) {
      setTimeout(connect, 2000);
    }
  };
}
connect();

Flask SSE 长连接卡住、CPU 占高、或者并发撑不住怎么办

Flask 默认开发服务器(Werkzeug)是单线程同步模型,一个 SSE 连接就会占住一个 worker,100 个用户连上来,它就卡死。这不是代码写错了,是部署方式错了。

生产环境必须换异步服务器,否则所有优化都白搭。另外,别在生成器里做耗时操作(比如查数据库、调外部 API),会阻塞整个流。

  • 开发调试可用 flask run --reload --no-debugger,但仅限 1–2 人测试
  • 生产必须用 gunicorn + gevent 或 uvicorn(搭配 hypercorn 更稳),并显式启用 async workers
  • 若需广播(如发消息给所有客户端),别用全局 list 存 connection —— Flask 没共享内存,得用 Redis + Pub/Sub 或消息队列
  • 每个 yield 后建议 time.sleep(0.01) 让出控制权,尤其用 gevent 时

为什么 Chrome 控制台看不到 SSE 数据,但 Network 里 status 是 200

因为 Chrome DevTools 的 Network 面板对 text/event-stream 支持有限:它显示连接建立成功(200),但不会实时渲染每条 data: 消息。你得靠 console.log 或 onmessage 打印才能确认是否收到。

另一个高频问题是跨域:如果前端域名和 Flask 后端不一致,EventSource 会静默失败(不触发 onerror),控制台只报 CORS 错误。SSE 不支持带凭证的跨域,除非后端明确允许。

  • 务必在 Flask 响应头加 Access-Control-Allow-Origin: *(或具体域名),否则前端连都连不上
  • 别用 localhost:3000 连 127.0.0.1:5000 —— 浏览器认为这是两个源
  • Chrome 的 Application → Service Workers 面板里也看不到 SSE,它和 SW 无关
  • 真要调试流内容,用 curl -N http://localhost:5000/sse 最直接,-N 关闭缓存
Flask SSE 的关键不在语法多难,而在于理解它是长生命周期 HTTP 连接,一环松动(服务模型、响应格式、前端重连、跨域)就会断。很多人卡在“明明代码跑通了却收不到数据”,其实问题早就不在 Python 里了。
PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
flask框架如何搭建
flask框架如何搭建

搭建步骤:1、安装Python和Pip;2、创建虚拟环境;3、安装Flask;4、创建Flask应用;5、运行应用;6、访问应用。想了解更多flask框架的相关内容,可以阅读本专题下面的文章。

2024.06.27

2935

8

Python Flask框架
Python Flask框架

本专题专注于 Python 轻量级 Web 框架 Flask 的学习与实战,内容涵盖路由与视图、模板渲染、表单处理、数据库集成、用户认证以及RESTful API 开发。通过博客系统、任务管理工具与微服务接口等项目实战,帮助学员掌握 Flask 在快速构建小型到中型 Web 应用中的核心技能。

2025.08.25

4384

10

Python Flask Web框架与API开发
Python Flask Web框架与API开发

本专题系统介绍 Python Flask Web框架的基础与进阶应用,包括Flask路由、请求与响应、模板渲染、表单处理、安全性加固、数据库集成(SQLAlchemy)、以及使用Flask构建 RESTful API 服务。通过多个实战项目,帮助学习者掌握使用 Flask 开发高效、可扩展的 Web 应用与 API。

2025.12.15

276

16

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

20

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

0

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

0

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

20

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

0

19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.2万人学习