异步函数中调用同步代码会阻塞事件循环，导致其他协程无法执行；同步上下文调用异步函数需避免嵌套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事件循环。
安全做法包括：
立即学习“Python免费学习笔记（深入）”；
- 顶层入口统一用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
