flask 1.x默认不支持asyncio，直接await会因无事件循环而挂起；flask 2.0+需搭配uvicorn等asgi服务器且路由声明为async def才能真正启用异步，混用同步i/o仍会导致阻塞。
Flask 1.x 默认不支持 asyncio，直接 await 会卡死
Flask 1.x（包括 1.1.4 及更早版本）的请求处理完全基于同步 WSGI，app.run() 启动的是阻塞式服务器。你在路由函数里写 await asyncio.sleep(1) 或调用 await aiohttp.ClientSession().get(...)，程序不会报错，但会永远挂起——因为事件循环没运行，await 等不到被调度，主线程又卡在 WSGI 的同步调用里，形成典型死锁。
常见现象：浏览器请求一直 pending，Ctrl+C 后看到堆栈停在 asyncio.base_events.BaseEventLoop.run_until_complete 或根本没进协程体；日志里看不到任何响应输出。
- 别试图在 Flask 1.x 路由中直接
await任意协程 - 别用
asyncio.run()包裹协程——它每次新建事件循环，在多线程 WSGI 环境下会报RuntimeError: There is no current event loop in thread - Flask 2.0+ 才开始实验性支持
async def路由，但默认仍走同步路径，需显式启用异步适配器（见下条）
Flask 2.0+ 启用 async route 必须配 uvicorn 或 hypercorn
Flask 2.0 引入了 async def 路由语法，但只是“语法糖”——底层仍依赖 ASGI 服务器驱动事件循环。如果你继续用 flask run（即 Werkzeug 开发服务器），它仍是 WSGI 模式，async 路由会被静默降级为同步执行，await 不生效，甚至可能引发 RuntimeWarning: coroutine 'xxx' was never awaited。
正确做法是换 ASGI 服务器，并确保启动方式匹配：
- 安装
uvicorn：pip install uvicorn - 路由必须定义为
async def，且返回可 await 对象（如await aiohttp.get(...)结果） - 启动命令改为：
uvicorn myapp:app --reload（myapp是模块名，app是 Flask 实例名） - 不能混用：
app.run()和uvicorn互斥；Werkzeug 的--debug在 uvicorn 下无效
示例片段：
from flask import Flask
import aiohttp
<p>app = Flask(<strong>name</strong>)</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill3219" title="python全能编程助手"><img
src="https://img.php.cn/upload/skill/000/000/081/178952049933674.jpg" alt="python全能编程助手" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill3219" title="python全能编程助手" class="overflowclass">python全能编程助手</a>
<p class="overflowclass">SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、</p>
</div>
<a rel="nofollow" href="/xiazai/skill3219" title="python全能编程助手" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><p>@app.route('/fetch')
async def fetch_data():
async with aiohttp.ClientSession() as session:
async with session.get('<a href="https://www.php.cn/link/c2148796071914983ed6b6e9dbbff735">https://www.php.cn/link/c2148796071914983ed6b6e9dbbff735</a>') as resp:
return await resp.json() # ✅ 正确：在 ASGI 环境中 await
</p>
混合同步/异步逻辑时，避免在 async route 中调用阻塞 I/O
即使用了 uvicorn，只要你在 async def 路由里写了 requests.get()、time.sleep()、open()（未用 aiofiles）、或任何 CPU 密集型操作，整个事件循环就会被阻塞，后续所有请求排队等待——表现和死锁一样，只是原因不同。
- HTTP 请求必须用
aiohttp、httpx.AsyncClient等异步库，禁用requests - 文件读写用
aiofiles，而非内置open - 延迟用
await asyncio.sleep()，不用time.sleep() - CPU 密集任务（如 JSON 解析、图像处理）必须用
loop.run_in_executor()脱离事件循环执行
错误示范：requests.get('https://...') 在 async route 中会卡住整个 uvicorn worker。
Flask 扩展（如 SQLAlchemy、Redis）多数不原生支持 async
绝大多数 Flask 扩展基于同步驱动设计。例如 flask-sqlalchemy 1.x / 2.x 的 db.session.query() 是阻塞调用，放进 async def 路由等于主动制造阻塞点。强行使用会导致 uvicorn worker 冻结，超时后连接被重置。
目前较稳妥的方案只有两个：
- 用官方异步分支：
SQLAlchemy 2.0++flask-sqlalchemy 3.0+，并配置engine = create_async_engine("sqlite+aiosqlite:///...", echo=True)，再用await session.execute(...) - 对不支持 async 的扩展（如旧版 Flask-Redis），改用线程池包装：
await loop.run_in_executor(None, lambda: redis_client.get('key'))
注意：flask-login、flask-wtf 等中间件类扩展基本无 async 支持，涉及 session、表单验证的逻辑仍建议放在同步路由中处理。
Flask 的 async 支持本质是“ASGI + 协程语法”，不是魔法。真正容易被忽略的是：你得同时满足三个条件——Flask ≥2.0、路由声明为 async def、服务器是 uvicorn/hypercorn——缺一不可；而任何一处混入同步 I/O，都会让整个异步链路退化成假并发。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
