Python协程取消是协作式机制,需主动检查CancelledError并配合可取消await点;纯CPU密集型代码无法取消,须插入挂起点;清理逻辑在finally中仍会执行;子任务不自动继承取消,需手动管理。
Python 协程的取消机制不是自动传播的,必须主动检查、响应并协作完成;它依赖 asyncio.Task 的 cancel() 方法触发,但真正中断执行靠的是协程内部对 CancelledError 的捕获与处理,以及可取消等待对象(如 asyncio.sleep()、await task)在被取消时及时抛出异常。
协程不会被“强行杀死”,取消请求只是设置任务状态为 CANCELLED,并调度一次事件循环——下一次遇到可取消的 await 点时,运行时才检查是否被取消,并抛出 asyncio.CancelledError(继承自 Exception,但不继承自 BaseException)。这意味着:
while True: pass)无法被取消,必须插入 await asyncio.sleep(0) 或其他挂起点让出控制权try/except Exception: 不会捕获 CancelledError,需显
except asyncio.CancelledError: 或 except BaseException:
finally 或 async with / async for 清理逻辑中被取消,仍会进入清理块,适合释放资源编写健壮协程时,应预设取消可能发生在任意 await 处。推荐做法包括:
try/finally 或 async with 保证资源释放(例如关闭连接、删除临时文件)await asyncio.sleep(0) 或 await asyncio.wait([pending_task], timeout=0.1) 提供取消检查点asyncio.shield() 包裹不希望被取消的子任务(如心跳发送),避免父任务取消时误伤aiohttp.ClientSession.get() 可被取消,而某些自定义 Future 可能不响应)默认情况下,子任务(如通过 asyncio.create_task() 启动)不会自动随父任务取消而取消;取消是单向、非继承的。若需级联取消,需手动管理:
finally 块中显式调用 child_task.cancel()
asyncio.gather(..., return_exceptions=True) 并配合 return_exceptions=False(默认)让任一子任务取消导致整个 gather 抛出 CancelledError
await 会立即抛出 CancelledError,无需重复 cancel当协程看似“没被取消”时,常见原因有:
asyncio.Future 的 awaitable)CancelledError 却没重新抛出(例如 except asyncio.CancelledError: pass)task.done() 为 True),此时 cancel() 返回 False
loop.run_until_complete() 但未 await 任务本身,而是直接运行协程对象,导致无法通过 Task 控制生命周期可通过 task.cancelled()、task.done() 和 task.exception() 检查任务最终状态,辅助定位问题。