Future对象捕获异常但不自动抛出，必须显式调用result()或exception()才能暴露；as_completed()是安全获取结果和异常的推荐方式，map()则延迟且集中抛出首个异常。
ThreadPoolExecutor.submit() 返回的 Future 对象必须显式检查异常
默认情况下，ThreadPoolExecutor 中任务抛出的异常不会立即传播，也不会中断主线程。它被静默捕获并绑定到返回的 Future 实例上——只有调用 future.result() 或 future.exception() 时才会暴露。
常见错误是只调用 submit() 就不管了，结果任务失败了却毫无感知：
with ThreadPoolExecutor() as executor:
futures = [executor.submit(divide, 10, 0) for _ in range(3)]
# 此处不检查 future，异常就丢了- 务必对每个
future调用future.result()（会抛出原始异常）或future.exception()（返回异常对象或None） -
future.done()只表示执行完成，不表示成功；future.cancelled()和future.running()也都不反映异常状态 - 若在循环中批量获取结果，建议用
concurrent.futures.as_completed(futures)，避免按提交顺序阻塞等待
as_completed() 是安全获取异常结果的推荐方式
相比手动遍历 futures 列表并逐个调用 result()，as_completed() 按完成顺序 yield Future，能更早发现失败任务，且不因某个慢任务卡住整个流程。
from concurrent.futures import ThreadPoolExecutor, as_completed
<p>def risky_task(x):
if x == 2:
raise ValueError("boom")
return x * x</p><p>with ThreadPoolExecutor() as executor:
futures = {executor.submit(risky_task, i): i for i in range(5)}
for future in as_completed(futures):
try:
result = future.result() # ← 这里触发异常
print(f"Success: {result}")
except ValueError as e:
print(f"Caught: {e}") # ← 捕获原始异常类型和消息
except Exception as e:
print(f"Unexpected error: {type(e).<strong>name</strong>}: {e}")-
as_completed()不保证返回顺序，但保证每个future只 yield 一次 - 即使部分任务已失败，其余仍在运行的任务仍会被正常 yield 出来
- 不要在
as_completed()循环外提前调用future.result()，否则可能重复抛异常或引发InvalidStateError
map() 方法会隐式收集异常，但只在全部任务完成后才爆发
executor.map(func, iterable) 看似简洁，但它把所有任务结果（或首个异常）攒到一起：只要有一个任务失败，map() 迭代器在首次取值时就抛出该异常，其余任务的结果全丢失。
立即学习“Python免费学习笔记（深入）”；
with ThreadPoolExecutor() as executor:
try:
results = executor.map(divide, [10, 5, 0], [2, 1, 2])
list(results) # ← 第三个任务失败，此处才 raise ZeroDivisionError
except ZeroDivisionError:
print("One task failed — but we don't know which, and others are gone")-
map()适合「全成功才有意义」的场景，比如批量转换；不适合需要容错或诊断单个失败的任务 - 它不支持传入额外参数（除非用
functools.partial或 lambda 包装），灵活性不如submit() - 无法区分是哪个输入导致失败，也无法获取其它已完成任务的结果
未处理的异常会滞留在 Future 中，直到被访问或对象被回收
Future 对象本身会持有异常引用，但不会自动打印或记录。如果程序结束前既没调用 result() 也没调用 exception()，异常就只是内存里的一个对象，不会触发任何日志或警告。
- 这容易造成「任务看似跑完，实则全失败」的假象，尤其在脚本结尾没做清理时
- 若使用
wait(futures)，它只返回完成/未完成列表，完全不触碰异常状态 - 生产环境建议在 finally 块或上下文退出前，遍历所有 futures 并至少调用一次
future.exception()记录日志
最易被忽略的一点：异常堆栈中的文件名和行号指向的是子线程内执行的位置，不是 submit() 调用点——调试时得顺着 Future 的生命周期去定位源头。
