anext()必须await，否则返回协程对象而非值；需先aiter()获取异步迭代器；default参数用于流控分支；配合wait_for防卡顿；手动调用适用于条件读取等复杂场景。
anext 必须 await，不 await 就卡死
直接写 anext(it) 不加 await，结果不是报错，而是协程对象原样返回，后续代码继续执行——但你拿到的不是值，是个待调度的 coroutine 对象。事件循环根本没跑它，数据自然不会来。常见错误是把 anext 当成同步函数用，尤其从 next() 迁移过来时容易忽略这点。
-
anext()返回的是可等待对象（awaitable），必须await才能驱动执行 - 如果漏掉
await，后续用print()或计算会看到类似<coroutine object anext at 0x...>的输出 - 在
async for内部，解释器自动处理了await；但手动调用时，这一步完全由你负责
aiter() 不是可选步骤，它是获取异步迭代器的唯一标准入口
不能跳过 aiter() 直接对异步生成器或自定义类调用 anext()。Python 规定：只有实现了 __aiter__() 方法的对象才是“异步可迭代对象”，而 aiter(obj) 就是调用它的标准方式。绕过它（比如试图直接 await obj.__anext__()）会破坏协议一致性，且在某些对象上根本不可行——例如异步生成器函数返回的对象，没有公开的 __anext__ 属性可供直接调用。
-
aiter(agen())是合法的；anext(agen())会报TypeError: 'async_generator' object is not an async iterator - 自定义类中，
__aiter__必须返回自身（或另一个实现了__anext__的对象），否则aiter()调用失败 - 即使类里写了
__anext__，没实现__aiter__，aiter()仍会抛TypeError
默认值参数 default 不止防异常，还影响流控逻辑
anext(it, default) 看似只是避免 StopAsyncIteration，实际在流式场景中，它是主动判断“数据是否结束”的信号。比如轮询 WebSocket 流时，你可能希望：有新数据就立刻处理，没数据就 sleep 100ms 再试。这时 default 就是你做分支判断的依据，而不是单纯兜底。
- 设
default=None，拿到None就知道该等一等再取，而不是无脑重试 - 不设
default时，必须用try/except StopAsyncIteration:捕获，代码更啰嗦，且异常路径在高频轮询中开销略高 - 注意：
default值本身不能是StopAsyncIteration实例，否则语义混淆
流式处理中，anext 配合 asyncio.wait_for 可防单次卡顿
真实网络流（如 aiohttp 的 content.iter_any()）可能因网络抖动迟迟不返回下一项。只靠 anext() 会无限等待，拖垮整个协程。必须叠加超时控制，而 asyncio.wait_for() 是最直接的方式。
立即学习“Python免费学习笔记（深入）”；
- 写法是：
await asyncio.wait_for(anext(it), timeout=5.0) - 超时后抛
asyncio.TimeoutError，你可以选择重连、降级或记录告警 - 不要用
asyncio.sleep()+ 循环重试代替，那会浪费 CPU 且无法真正中断阻塞的__anext__调用 - 若底层
__anext__自身已含超时（如某些数据库驱动），再套一层wait_for可能冗余，需看具体实现
真正难的不是调用 anext，而是理解它和 async for 的分工：前者让你在“取一个值”之后，能插入任意逻辑（比如根据值决定要不要继续取、要不要切换到另一路流）；后者只适合“全量消费”。一旦需要条件跳过、提前退出、交叉读取多个流，手动用 aiter + anext 就绕不开。
