在同步代码中引入异步的核心是避免阻塞主线程且不破坏调用结构，常用方法包括：用asyncio.run()封装（适用于无运行中事件循环的场景）、在已有事件循环中使用run_until_complete()、或通过ThreadPoolExecutor线程桥接异步操作。
在同步代码中引入异步，核心是避免阻塞主线程，同时不破坏原有调用结构。最常用、最稳妥的方式是用 asyncio.run() 封装异步函数，或借助线程/进程将异步逻辑“桥接”进同步环境。
直接运行单次异步函数
如果只是偶尔调用一个异步函数（比如发一次 HTTP 请求、读一次数据库），且当前没有运行中的事件循环，最简单的方法是：
- 用
asyncio.run(coro)启动新事件循环并等待完成 - 该函数会自动创建、运行、关闭事件循环，适合脚本顶层或命令行工具
- 注意：不能在已有事件循环中调用（如 Jupyter、FastAPI 路由里），否则报错
示例：
import asyncioimport aiohttp
async def fetch_data():
async with aiohttp.ClientSession() as session:
async with session.get("https://httpbin.org/json") as resp:
return await resp.json()
# 在同步函数中调用
def sync_handler():
data = asyncio.run(fetch_data()) # ✅ 安全、简洁
print(data)
在已有事件循环中安全调用
当你的同步代码已处于异步上下文（例如 FastAPI 的依赖、Tornado 的 handler、或你自己启了 loop），不能再用 asyncio.run()。此时应：
- 用
asyncio.get_event_loop().run_until_complete(coro) - 或更推荐：用
asyncio.create_task()+loop.run_until_complete()配合 await（需确保你在协程内） - 若不确定是否已有 loop，可用
asyncio.new_event_loop()+set_event_loop()手动管理（慎用，易出错）
用线程桥接异步操作（适合 I/O 密集型）
当同步代码无法修改（如遗留系统、第三方库回调），又必须调用异步函数时，可把异步任务扔进线程执行：
- 用
concurrent.futures.ThreadPoolExecutor提交一个包装函数，内部调用asyncio.run() - 适合短时、独立的异步调用（如发邮件、查缓存），避免污染主线程事件循环
- 注意：频繁创建事件循环有开销，不适合高频调用
示例：
from concurrent.futures import ThreadPoolExecutorimport asyncio
def sync_call_async():
with ThreadPoolExecutor() as pool:
result = pool.submit(asyncio.run, fetch_data()).result()
return result
避免常见陷阱
- 不要在同步函数里直接
await—— 语法错误，Python 会提示 “SyntaxError: 'await' outside async function” - 不要在多线程中复用同一个事件循环 —— 默认 loop 不是线程安全的，需用
asyncio.run()或为每个线程新建 loop - 不要用
time.sleep()替代await asyncio.sleep()—— 前者会阻塞整个线程，后者只挂起当前协程
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
