为何无法阻止asyncio任务中KeyboardInterrupt的栈追踪输出？

问题现象 #

• 常规异常（如TypeError、asyncio.CancelledError）在await asyncio.Task时被捕获后，不会自动触发异常栈追踪上报
• KeyboardInterrupt即使被内层except块成功捕获，控制台依然会打印异常栈，外层的KeyboardInterrupt捕获分支永远不会触发，Python 3.8环境下稳定复现
• 尝试调用t.set_exception(None)无法解决问题

测试代码如下：

class CatchAsyncTest(unittest.IsolatedAsyncioTestCase):
    async def test_catch(self):
        async def e(clz):
            raise clz()

        try:
            
            try:
                # t = asyncio.Task(e(asyncio.CancelledError))  # 可正常捕获，无栈追踪打印
                # t = asyncio.Task(e(TypeError))               # 可正常捕获，无栈追踪打印
                t = asyncio.Task(e(KeyboardInterrupt))       # 可捕获，但始终打印栈追踪
                await t
            except (KeyboardInterrupt, asyncio.CancelledError, TypeError) as e:
                # t.set_exception(None) # 无效
                print(f"done={t.done()} Caught", type(e), file=sys.stderr)
                # 未重新抛出异常
                
        except KeyboardInterrupt as e:
            print("@@@", type(e), file=sys.stderr)  # 永远不会触发

运行输出对比 #

KeyboardInterrupt场景输出：

done=True Caught <class 'KeyboardInterrupt'>
Traceback (most recent call last):
  File "/.../tests.py", line 215, in e
    raise clz()
KeyboardInterrupt

TypeError等普通异常场景输出（无栈追踪）：

done=True Caught <class 'TypeError'>

根本原因 #

Python 3.8的asyncio.Task对异常做了分级处理：

• 所有继承自Exception的普通异常（包括TypeError、CancelledError），只要在await任务时被捕获、或者主动调用过task.exception()获取过异常，就会被标记为「已处理」，不会触发自动栈追踪打印
• KeyboardInterrupt、SystemExit这类直接继承自BaseException的系统级退出异常，在3.8版本的Task实现里被特殊判定为必须上报的致命异常：无论是否在await时捕获了异常，Task回收时都会强制走事件循环的异常上报逻辑打印栈，且不会按普通异常的传播路径向外层冒泡，这也是外层捕获分支永远不触发的原因。
• 任务进入done=True状态后不允许修改绑定的异常值，因此t.set_exception(None)调用无效。

解决方法 #

根据实际场景选择即可：

• 单元测试场景：不要主动抛KeyboardInterrupt模拟中断，用自定义异常替代即可。真实运行环境中KeyboardInterrupt由OS信号触发直接投递到事件循环，不会从普通业务Task中抛出。
• 业务场景确需处理且要屏蔽栈打印：给事件循环注册自定义异常处理器，过滤掉已捕获的KeyboardInterrupt上报，参考代码：

import asyncio
import sys

# 注册自定义异常处理器
loop = asyncio.get_running_loop()
original_handler = loop.get_exception_handler()
def custom_exception_handler(loop, context):
    exc = context.get("exception")
    # 过滤已经被捕获的KeyboardInterrupt上报
    if isinstance(exc, KeyboardInterrupt):
        return
    if original_handler:
        original_handler(loop, context)
    else:
        loop.default_exception_handler(context)
loop.set_exception_handler(custom_exception_handler)

• 升级Python到3.11+版本，该版本调整了Task的异常判定逻辑，只要异常被await获取，就不会再强制上报栈追踪。

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