Python异步任务退出时是否需手动取消？机制与最佳实践问询

我没找到清晰描述该机制的文档，想了解相关原理与最佳实践。通过asyncio.create_task创建的任务，在程序结束时似乎会自动清理，不会抛出CancelledError，也无需显式调用取消方法。我们到底需要手动取消任务以确保有序关闭，还是asyncio事件循环会自动妥善处理所有清理工作？

以下是示例代码，程序运行20秒后似乎能正常退出。我假设这种写法是可行的，希望确认是否违反了最佳实践。

import asyncio
import random
import time


async def forever_while_loop_task():
    while True:
        sleep_seconds = random.randint(5, 30)
        print(f'sleeping for {sleep_seconds} seconds')
        await asyncio.sleep(sleep_seconds)
        print('looping')


async def main():
    start = time.monotonic()
    the_looping_task = asyncio.create_task(forever_while_loop_task())
    await asyncio.sleep(20)
    print(f'ok done with program, took {time.monotonic() - start:.2f}s')

    # Do I need to call the_looping_task.cancel() here 
    # or do anything to ensure orderly shutdown/cleanup?


if __name__ == "__main__":
    asyncio.run(main())

某次运行的示例输出：

sleeping for 12 seconds
looping
sleeping for 27 seconds
ok done with program, took 20.00s

核心结论 #

不需要手动取消示例中的任务，但这取决于你的任务是否涉及需要收尾的资源操作。

原理说明 #

当asyncio.run()执行完成时，会自动关闭事件循环。事件循环关闭前，会强制终止所有未完成的任务，但这个过程不会触发任务的CancelledError——因为是直接终止，不走正常的取消流程。就像你示例里的情况，任务卡在await asyncio.sleep(27)时被直接终止，不会抛出任何错误。

最佳实践建议 #

• 如果任务只是简单的循环、没有占用需要释放的资源（比如示例里的打印+sleep），完全不需要手动取消，程序退出时事件循环会处理干净。
• 如果任务持有需要释放的资源（比如文件句柄、数据库连接、网络套接字），必须手动取消任务，并在任务内部捕获CancelledError，执行资源清理逻辑。比如：

async def task_with_resources():
    try:
        while True:
            # 执行资源相关操作
            await asyncio.sleep(10)
    except asyncio.CancelledError:
        # 这里做清理：关闭文件、断开连接等
        print("清理资源后退出")
        raise  # 必须重新抛出异常，让任务正常结束

• 如果你希望任务能完成当前迭代再退出，也应该手动取消，让任务收到取消信号后自行控制收尾逻辑，而不是被强制终止。

内容的提问来源于stack exchange，提问作者chacmool