调用空异步生成器的anext()方法时为何抛出SystemError: <class 'StopIteration'> returned with exception set？

这个问题确实有点反直觉，毕竟按照anext()的文档说明，迭代器耗尽时应该返回指定的default值才对。咱们一步步拆解原因和解决办法：

问题根源 #

核心问题出在空异步生成器的内部实现细节上：
当你的generator()函数在it is None时没有任何yield语句，这个异步生成器对象的__anext__方法执行时会直接走到函数末尾返回None。而Python的异步生成器机制在处理这种"无yield直接返回"的情况时，内部异常出现了错误转换——本该抛出StopAsyncIteration（让anext()捕获并返回default），但实际却触发了StopIteration；在asyncio的协程上下文里，StopIteration会被进一步包装成SystemError，最终导致代码崩溃。

为什么第一个调用能正常工作？ #

当你传入it=1时，generator(1)执行了yield (it, it)语句，生成器的__anext__方法会正常返回yield的值，不会触发"无yield返回"的异常转换问题，所以anext()能正确拿到结果并完成解包。

而async for循环遍历generator()时，因为生成器本身是空的，所以循环体自然不会执行，这是符合预期的正常行为。

解决办法 #

最简单的修复方式是确保异步生成器函数至少包含一个yield语句——哪怕是永远不会被执行的"空yield"，这样Python的生成器机制会正确按照异步迭代器协议抛出StopAsyncIteration，让anext()可以正常捕获并返回default值。

修改后的generator函数如下：

async def generator(it=None):
    if it is not None:
        yield (it, it)
    # 添加一个永远不会执行的yield，确保生成器符合异步迭代器协议
    if False:
        yield

如果不想修改生成器函数，也可以显式捕获异常兜底：

try:
    a, b = await anext(generator(), (2, 3))
except (StopAsyncIteration, SystemError):
    a, b = (2, 3)

补充说明 #

这个异常在Python 3.11、3.12、3.13中都存在，属于异步生成器实现的边缘case问题。只要保证异步生成器函数不会"无yield直接返回"，就能避开这个坑。

备注：内容来源于stack exchange，提问作者MKO