flask 3.x 异步视图必须用 async def 定义，且需 asgi 服务器（如 uvicorn）支持，wsgi 服务器会静默降级为同步执行；异步视图中须用 aiohttp 或 httpx.asyncclient 等协程库，禁用 requests、time.sleep 等阻塞操作。
Flask 3.x 异步视图函数必须用 async def，且应用需运行在支持异步的 WSGI 替代品上
Flask 3.x 原生支持 async 视图函数，但仅限于底层服务器能处理协程——标准 WSGI（如 werkzeug 开发服务器）不支持 await，直接运行会抛出 RuntimeError: Attempted to run async function synchronously。
- 开发时可用 Flask 内置服务器，但必须加
--debug --reload并确保 Python ≥ 3.8，它会自动启用asyncio事件循环（仅限调试） - 生产环境必须换用 ASGI 服务器：推荐
uvicorn或hypercorn，不能用gunicorn（默认 WSGI 模式） - 若混用同步/异步视图，Flask 会自动调度，但不要在
async视图里调用阻塞式库（如requests、sqlite3），否则会阻塞整个事件循环
异步视图中调用 HTTP 请求必须用 aiohttp 或 httpx.AsyncClient
常见错误是把同步 requests.get() 直接塞进 async 函数里，这会导致事件循环卡死——因为 requests 是阻塞 I/O，不是协程。
- 改用
httpx.AsyncClient：安装httpx后，用async with httpx.AsyncClient() as client:+await client.get(...) - 避免在异步视图里用
time.sleep()，改用await asyncio.sleep() - 数据库操作需对应异步驱动：如
asyncpg（PostgreSQL）、aiomysql，ORM 推荐SQLModel配合asyncio或原生sqlalchemy.ext.asyncio
app.route 装饰器写法不变，但函数签名和返回值类型需匹配异步语义
Flask 3.x 对异步支持是向后兼容的，装饰器语法没变，但内部执行逻辑已适配 await。关键点在于返回值：异步视图仍应返回 str、Response 或可 JSON 序列化的对象，Flask 会自动 await 它。
- 正确写法：
@app.route("/api/data")<br>async def get_data():<br> data = await fetch_remote_data() # 返回协程<br> return {"result": data} - 错误写法：
return await json.dumps(...)——json.dumps不是协程，无需await；也不要用return asyncio.create_task(...)，Flask 期望的是可等待对象或普通值 - 如果视图里混合同步逻辑（比如格式化字符串），直接写即可，只有真正耗时 I/O 才需要
await
并发压测时发现性能未提升？检查是否触发了隐式同步回退
Flask 在检测到异步视图但运行在非 ASGI 环境时，会静默降级为同步执行，表面不报错，但实际失去并发优势——这是最隐蔽的坑。
- 启动时观察日志：uvicorn 启动会打印
Uvicorn running on http://...，而flask run默认仍是 WSGI 模式，即使函数是async也无效 - 用
psutil查看进程线程数，ASGI 服务器通常只启少量线程+事件循环，WSGI 则靠多进程/多线程撑并发 - 加一行
print(asyncio.iscoroutinefunction(get_data))确认函数确实被识别为协程；再用asyncio.current_task()在视图里打印任务 ID，验证是否真在事件循环中运行
Flask 的异步能力很实在，但依赖外部服务器和 I/O 库的配合；漏掉任一环，代码看着像异步，跑起来还是单线程阻塞。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
