近日，在Python开发者社区中，一个关于KeyboardInterrupt与asyncio.CancelledError异常处理的话题引发了广泛讨论。许多开发者发现，在异步编程中，当使用try...except语句捕获KeyboardInterrupt（用户按Ctrl+C触发的中断）时，往往会不小心连带捕获到asyncio.CancelledError（协程取消异常），导致程序行为异常。这个看似微小的细节，却常常让调试变得困难重重。本文将深入剖析这一陷阱，并提供正确的处理方案。

两种异常的“血缘”关系

KeyboardInterrupt是Python内置异常，当用户按下Ctrl+C时由信号处理器抛出。而asyncio.CancelledError是asyncio库在协程被取消时抛出的异常，例如通过task.cancel()方法触发。两者在Python异常继承体系中属于不同的分支——KeyboardInterrupt继承自BaseException（与SystemExit、GeneratorExit同级），而asyncio.CancelledError继承自Exception（常规异常的子类）。

然而，在Python 3.8及更早版本中，asyncio.CancelledError同样继承自BaseException。这意味着，如果一个except KeyboardInterrupt块使用的是裸except（或者使用了except Exception但未过滤BaseException），就会误捕CancelledError。更糟糕的是，有些开发者习惯用except BaseException来捕获所有中断，这几乎必然会导致问题。

典型错误场景

假设我们有一个异步函数，需要优雅地处理用户中断：

import asyncio

async def worker():
    try:
        while True:
            await asyncio.sleep(1)
    except KeyboardInterrupt:
        print("收到键盘中断，正在清理...")

这段代码看起来没有问题，但如果worker协程是由某个任务调度器管理的，并且该调度器在程序关闭时尝试取消所有任务，那么CancelledError会在await asyncio.sleep(1)时被抛出。然而，由于except KeyboardInterrupt只捕获KeyboardInterrupt（继承自BaseException），而CancelledError在Python 3.8+中继承自Exception，上述代码实际上不会误捕。但是，如果开发者使用了更宽泛的捕获方式，比如：

except Exception as e:  # 这在Python 3.8之前会捕获CancelledError，之后不会

或者更常见的：

except:  # 裸except会捕获BaseException，包括CancelledError和KeyboardInterrupt

在Python 3.8之前，CancelledError也属于BaseException，因此裸except会吞噬它，导致协程无法正确响应取消请求，进而造成死锁或资源泄漏。

Python 3.8的破局与新的挑战

Python 3.8将asyncio.CancelledError从BaseException迁移到了Exception，旨在让开发者能通过普通的except Exception捕获它，同时避免与KeyboardInterrupt混淆。然而，这一改变也带来了新的问题：旧代码中那些依赖except BaseException或except来捕获所有异常的模块，可能会意外漏掉CancelledError，导致取消信号被忽略。

例如，在任务取消时，如果某个协程内部使用了try: ... except: pass（这是一个非常糟糕的实践），那么在Python 3.8+中，CancelledError会被这个裸except捕获并抑制，使得asyncio无法感知取消完成，最终导致程序无法正常停止。这也正是“Catch KeyboardInterrupt but not asyncio.CancelledError”这一标题的核心矛盾所在——开发者需要既能捕获用户中断，又不干扰协程的正常取消机制。

正确的处理模式

那么，应该如何在异步代码中安全地处理KeyboardInterrupt，同时保留对CancelledError的响应能力呢？社区推荐的最佳实践如下：

1. 区分异常继承链
由于KeyboardInterrupt和SystemExit都继承自BaseException，而CancelledError现在继承自Exception，可以采用层次化的except语句：

try:
    await long_running_task()
except KeyboardInterrupt:
    # 处理用户中断，例如清理资源
    ...
except asyncio.CancelledError:
    # 允许协程取消，通常不做特殊处理，重新抛出即可
    raise
except Exception as e:
    # 处理其他常规异常
    ...

2. 使用signal模块注册自定义处理器
对于更精细的控制，可以在主事件循环外部通过signal.signal注册SIGINT处理器，并通过loop.call_soon_threadsafe或loop.stop()来安全地停止事件循环，而不是直接抛出异常。

3. 避免裸except
永远不要使用裸except:，尤其是在异步上下文中。如果必须捕获所有异常，应明确写成except BaseException，并在块内区分出CancelledError和KeyboardInterrupt。

实际案例：服务重启时挂起

某公司的微服务团队曾遇到一个诡异问题：当通过Kubernetes的preStop钩子发送SIGINT信号时，部分Python asyncio服务无法在规定时间内关闭，导致容器被强制终止（SIGKILL）。排查后发现，开发人员在协程入口处使用了try: ... except: pass来“保证”程序不因意外而崩溃，结果这个裸except吞噬了由任务取消引发的CancelledError，导致asyncio无法完成优雅关机流程。修复方案就是将裸except改为except Exception（并处理CancelledError之外的其他异常），或明确重新抛出CancelledError。

未来展望

随着Python 3.9+的普及，CancelledError已稳定归属Exception，开发者可以更自信地使用except Exception来捕获常规错误而不必担心干扰取消机制。但旧版兼容性仍需考虑。asyncio官方文档建议：始终将CancelledError视为“不可被无意义吞噬”的异常，避免在协程中滥用try...except，如果不想处理，就让它向上传播。

总之，KeyboardInterrupt与asyncio.CancelledError的纠缠，既反映了Python异常体系的演变，也提醒着我们：在异步编程的精细世界中，每一层异常处理都需谨慎设计。只有尊重协程的生命周期，才能写出鲁棒的并发程序。