StopAsyncIteration由Python解释器在异步生成器执行完所有yield后自动抛出；手动实现__anext__时需显式raise，否则async for会卡住；异步生成器内无法捕获该异常，清理应放在finally中。
StopAsyncIteration 是怎么被抛出来的
异步生成器执行完所有 yield 后，下一次调用 __anext__() 会自动抛出 StopAsyncIteration —— 这不是你手动写的，是 Python 解释器在底层做的。你写 async def + yield，解释器就帮你生成了符合 __anext__ 协议的异步迭代器对象，它内部封装了状态机，当协程返回（return 或自然结束），就触发这个异常。
所以你不需要、也不应该在异步生成器里写 raise StopAsyncIteration；这么干不仅多余，还会让调用方收到两次异常（一次你手动 raise，一次解释器再 raise），导致 async for 提前中断或报错。
手动实现 __anext__ 时必须显式抛出
如果你没用 async def ... yield，而是手动写一个类来实现异步迭代器协议（即定义 __aiter__ 和 __anext__），那 __anext__ 就得自己控制终止逻辑：
- 每次成功 yield 一个值，就返回
awaitable（比如return value或return await some_coro()） - 当数据耗尽，必须显式
raise StopAsyncIteration - 漏掉这句会导致
async for永远卡住，因为协议没告诉它“结束了”
示例：
class ManualAsyncIterator:
def __init__(self, items):
self.items = items
self.index = 0
<pre class="brush:python;toolbar:false;">def __aiter__(self):
return self
async def __anext__(self):
if self.index >= len(self.items):
raise StopAsyncIteration # ← 必须有这一句
value = self.items[self.index]
self.index += 1
return value
常见误用：在异步生成器里 try/except StopAsyncIteration
有人想模仿同步生成器的写法，在异步生成器里捕获 StopAsyncIteration 做清理，比如：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
async def bad_example():
try:
yield 1
yield 2
except StopAsyncIteration: # ← 这个 except 永远不会触发
print("cleanup") # ← 不会执行
这是无效的：StopAsyncIteration 不是生成器内部抛给自己的，而是由外部调用者（比如 async for 或 anext()）在获取下一个值失败时收到的。生成器函数体里根本 catch 不到它。
正确做法是用 async with + __aenter__/__aexit__，或把清理逻辑放在 finally 块里（但注意：只有整个协程退出时才进 finally，而异步生成器的 finally 在所有 yield 结束后才执行）：
async def good_cleanup():
try:
yield 1
yield 2
finally:
print("cleanup") # ← 这里能执行，但时机是生成器彻底结束时
调试时怎么确认是不是 StopAsyncIteration 导致中断
如果 async for 突然退出，又没看到明显错误，可以临时加一层包装，捕获并打印异常：
- 不要直接
async for x in gen:，先用anext(gen)手动取值 - 套
try/except StopAsyncIteration:显式判断 - 注意：
anext()在 Python 3.10+ 才支持传default，老版本要用asyncio.create_task(anext(gen))配合asyncio.wait_for更麻烦
最简验证方式：
gen = your_async_generator()
try:
await anext(gen)
except StopAsyncIteration as e:
print("Generator exhausted:", e) # ← 看到这行就确认是它
真正容易被忽略的是：很多异步库（如 aiohttp 的 ClientResponse.content.iter_any()）返回的对象也是异步迭代器，它们的 __anext__ 实现可能因网络超时、连接关闭等抛其他异常（比如 ConnectionResetError），这时候你以为是 StopAsyncIteration，其实根本不是。得看具体异常类型，别一概而论。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
