异步函数中调用同步代码会阻塞事件循环，导致其他协程无法执行；同步上下文调用异步函数需避免嵌套 run()，应使用 create_task 或 run_coroutine_threadsafe；第三方同步库需替换为异步等价方案。
异步函数里调用同步代码会阻塞事件循环
Python 的 async/await 机制依赖单线程事件循环（如 asyncio.run()启动的 loop），一旦在协程中执行耗时同步操作（比如time.sleep()、普通数据库查询、requests.get()、文件读写等），整个事件循环会被卡住，其他协程无法调度——这和“多线程中 sleep 不阻塞主线程”完全不同。例如：
错误示例：
import asyncio import time <p>async def fetch_data(): time.sleep(3) # ⚠️ 同步阻塞！整个 asyncio loop 停摆 3 秒 return "done"</p><p>async def main(): await asyncio.gather(fetch_data(), fetch_data()) # 实际串行执行，总耗时约 6 秒 </p>同步代码中调用异步函数需显式驱动事件循环
在普通函数（非 async def）里直接 await 会报 SyntaxError；而用 asyncio.run() 嵌套调用又可能触发 RuntimeError: asyncio.run() cannot be called from a running event loop——常见于 Flask/Django 视图、click 命令或测试 setup 中。关键原则是： 一个进程同一时间只能有一个正在运行的 asyncio 事件循环。
安全做法包括：
- 顶层入口统一用 asyncio.run(main()) 启动
- 已有事件循环时（如 Jupyter、aiohttp server 内部），改用 asyncio.create_task() 或loop.create_task()
- 必须从同步上下文调用异步逻辑？用 asyncio.run_coroutine_threadsafe(coro, loop) 投递到指定 loop，并配合 result() 等待（注意线程安全）
第三方库兼容性是混合使用的最大雷区
很多常用库默认同步设计，未提供原生 async 接口：requests、sqlalchemy（非 async 版本）、pandas I/O、logging（默认 Handler 阻塞）。强行在协程中调用它们，等于埋下隐形性能炸弹。
替代方案需按场景甄别：
- HTTP 请求 → 改用 httpx.AsyncClient 或aiohttp.ClientSession
- 数据库 → 选用asyncpg（PostgreSQL）、aiomysql、或 SQLAlchemy 2.0+ 的AsyncEngine
- 文件操作 → 避免 open()，改用aiofiles 包
- 日志 → 使用支持异步 Handler 的 loguru，或自定义基于asyncio.to_thread() 的异步写入
混合模型下异常传播与上下文管理更脆弱
async with / async for 的资源管理器（如 aiohttp.ClientSession）若被包裹在同步 try/except 中，可能因 await 中断导致 __aexit__ 未执行，引发连接泄漏；同样，contextvars 在跨 await 边界时虽能保持，但在 threading.Thread 或concurrent.futures中会丢失。
建议实践：
- 所有异步资源生命周期严格限定在 async 函数内，用 async with 而非手动 close()
- 需要跨线程传递上下文？显式捕获 contextvars.copy_context() 并在线程中 restore
- 调试混合调用栈时，优先检查 asyncio.get_running_loop() 是否存在，再确认是否误用 loop.run_until_complete() 等低阶 API
