17370845950

如何检测当前事件循环是否为 uvloop 或 asyncio 默认循环
最可靠方式是用 isinstance(asyncio.get_running_loop(), uvloop.Loop) 判断,需先 try/except 导入 uvloop,并确保在运行中的事件循环上下文中调用。

怎么判断当前 asyncio 事件循环是 uvloop 实例

直接检查 asyncio.get_event_loop() 返回对象的类型是最可靠的方式。uvloop 的事件循环类名为 uvloop.Loop,而标准库用的是 asyncio.events._UnixSelectorEventLoop(Linux/macOS)或 asyncio.windows_events._WindowsSelectorEventLoop(Windows),但这些内部类名不建议硬匹配——应优先用 isinstance 判断。

实操建议:

  • import uvloop,再用 isinstance(asyncio.get_event_loop(), uvloop.Loop)
  • 如果未安装 uvloop,导入会失败,所以需加 try/except ImportError 包裹
  • 不要依赖 repr(loop)loop.__class__.__name__ 做字符串匹配,不同 uvloop 版本可能调整类名或模块路径

为什么不能只看 asyncio.get_event_loop_policy()

设置策略(如 uvloop.install())只是影响后续新建 loop 的默认实现,并不改变已存在的 loop 实例。即使调用了 uvloop.install(),若之前已手动创建并运行过标准 loop,get_event_loop() 仍可能返回旧的非-uvloop 实例。

常见错误现象:

  • if __name__ == '__main__': 外提前调用 asyncio.get_event_loop(),触发隐式创建,默认是标准 loop
  • 使用 asyncio.run() 启动协程时,它内部总会新建一个 loop(受当前 policy 控制),但你无法访问那个 loop 对象
  • 测试时用 pytest-asyncio 等插件,其 fixture 可能复用 loop,导致策略生效与否与预期不符

在异步函数里安全检测当前 loop 类型的写法

由于事件循环可能尚未启动、或处于关闭状态,直接调用 asyncio.get_event_loop() 有风险。推荐用 asyncio.get_running_loop()(Python 3.7+),它只在已有运行中 loop 时返回,否则抛 RuntimeError

示例代码片段:

import asyncio
try:
    import uvloop
except ImportError:
    uvloop = None

def is_using_uvloop(): try: loop = asyncio.get_running_loop() except RuntimeError: return False # no running loop if uvloop is None: return False retur

n isinstance(loop, uvloop.Loop)

注意:is_using_uvloop() 必须在协程内或事件循环已启动后调用,否则 get_running_loop() 会直接报错。

uvloop 和标准 loop 的行为差异会影响检测结果吗

不影响检测逻辑本身,但会影响你“何时能检测”和“检测是否有效”。uvloop 不支持 loop.set_debug(True) 的部分调试功能,且某些低层 API(如 loop._selector)根本不存在;标准 loop 在 Windows 上默认用 Proactor,而 uvloop 只支持 Selector 模式(即必须用 SelectorEventLoop 兼容接口)。这意味着:

  • 如果你在 asyncio.run() 外部、又没显式启动 loop,就调用检测函数,大概率得到 False 或异常,不是因为不是 uvloop,而是根本没有 loop
  • 在子进程或线程里调用检测,get_running_loop() 总是失败(loop 是线程局部的),此时检测无意义
  • 某些打包工具(如 PyInstaller)可能干扰 uvloop 的 C 扩展加载,导致 import uvloop 成功但 isinstance(..., uvloop.Loop) 永远为 False,需要额外验证 uvloop.new_event_loop() 是否可构造

真正容易被忽略的是:loop 类型不是全局状态,而是每个线程独立、每次 asyncio.run() 独立;检测结果只对当前执行上下文有效,不能缓存复用。