asyncio.gather()需设return_exceptions=True才能继续执行并收集全部结果，此时异常对象会作为列表元素返回，需用isinstance(r, BaseException)判别，结果顺序与输入严格一致。
gather 抛出第一个异常就中断，怎么让它继续执行并收集全部结果
默认情况下，asyncio.gather() 遇到任一协程抛出异常，会立即取消其余未完成任务，并把第一个异常直接抛出。这和“想看所有任务成败结果”的需求冲突——比如批量调用 API、并发验证多个配置项，你得知道哪几个失败了、各自错在哪。
关键解法就是启用 return_exceptions=True 参数。它会让 gather() 把异常对象也当作正常返回值塞进结果列表，而不是提前中断。
- 不加该参数：只要有一个
ValueError，其他还在跑的任务全被 cancel，你只拿到一个ValueError - 加了
return_exceptions=True：所有协程无论成功失败都跑完，结果列表里对应位置是str、int或ValueError实例
如何区分结果里的异常对象和正常返回值
启用了 return_exceptions=True 后，gather() 返回的是混合类型列表，必须手动判断每个元素是不是异常。不能靠 isinstance(x, Exception) 就完事——因为有些协程可能真返回了一个 Exception 实例（虽然少见，但合法）；更稳妥的方式是检查是否为异常实例且未被处理过。
- 推荐做法：用
isinstance(x, BaseException)判断（BaseException是所有异常的基类，包括Exception和KeyboardInterrupt等） - 注意：
asyncio.CancelledError也会被包裹进来，如果任务被外部取消，它也会出现在结果中 - 实际校验时建议搭配
traceback.format_exception()提取错误上下文，而不是只打印str(e)
示例片段：
立即学习“Python免费学习笔记（深入）”；
import asyncio
async def may_fail(n):
if n == 2:
raise ValueError("n is 2")
return f"done-{n}"
async def main():
tasks = [may_fail(i) for i in [0, 1, 2, 3]]
results = await asyncio.gather(*tasks, return_exceptions=True)
for i, r in enumerate(results):
if isinstance(r, BaseException):
print(f"Task {i} failed: {type(r).__name__}: {r}")
else:
print(f"Task {i} succeeded: {r}")
asyncio.run(main())
return_exceptions=True 会影响 cancel 行为吗
不影响。即使开了 return_exceptions=True，如果你在 gather() 运行中途调用 task.cancel() 或触发超时，未完成的任务仍会被取消——只是取消本身会以 CancelledError 形式进入结果列表，而不是被吞掉或静默忽略。
-
return_exceptions=True只改变“异常是否被传播”，不改变“任务生命周期控制” - 若需防止某任务被取消，得在它内部用
try/except CancelledError捕获并压制，或用asyncio.shield() - 超时场景下，建议配合
asyncio.wait_for()使用，否则gather()本身不提供超时机制
和 asyncio.as_completed 对比：什么情况该选哪个
gather() + return_exceptions=True 适合你要严格按输入顺序拿到全部结果（含异常）的场景；而 asyncio.as_completed() 是按完成先后返回，不保序，也不自带异常包裹逻辑——它遇到异常照样立刻抛出。
- 要批量发请求并汇总成败清单 → 用
gather(..., return_exceptions=True) - 要边完成边处理、且能容忍部分失败中断流程 → 用
as_completed()+ 外层 try - 想限制并发数（比如最多同时跑 5 个）→
gather()不管并发控制，得自己用asyncio.Semaphore包一层
容易被忽略的一点：gather() 的返回值顺序永远和传入协程的顺序一致，哪怕第 0 个最慢、第 9 个最先完成——这点在做索引对齐（比如关联原始 URL 列表）时非常关键，别误以为它像 as_completed() 那样乱序。
