Python如何捕获所有未处理的异常并记录日志_通过sys.excepthook
Python中未捕获异常默认仅输出到标准错误,缺乏时间戳和日志记录。可通过自定义sys.excepthook并借助logging模块写入文件,需注意钩子函数不可抛异常、处理多线程并发及使用exc_info参数保留完整堆栈。子线程、异步任务等场景需单独配置threading.excepthook或asyncio异常处理器。
Python 进程里那些没被 try/except 逮住的异常,最终都会落到 sys.excepthook 头上。默认情况下,它只是把堆栈往 sys.stderr 一扔,完事儿。可问题是,线上环境哪有这么简单?没有时间戳、不写文件、不区分运行环境——一旦服务出了问题,你拿什么去回溯?更别提后台线程静默崩溃、atexit 回调里悄悄异常、信号处理函数中途出错,这些场景默认钩子根本管不过来。

为什么默认的 sys.excepthook 不够用
一句话:它只负责把异常打印到标准错误输出,既不记录时间,也不写日志文件,更不会区分开发、测试、生产环境。这意味着,一旦线上服务出了岔子,你根本没法往回查——要是负责关键业务的线程突然静默退出,连个日志都找不到,调试就是两眼一抹黑。
如何安全替换 sys.excepthook 并写入日志文件
直接顶上去行不行?可以,但得注意几个坑:钩子函数自己不能再抛异常(否则进程直接 abort),要能扛住多线程并发调用,还要确保日志 handler 已经初始化好了。具体来说,有这几点值得留意:
- 优先用
logging.getLogger()获取已有的 logger,避免重复配置;如果还没初始化,先用logging.basicConfig()设好文件 handler - 钩子函数的签名必须是
(exc_type, exc_value, exc_traceback),三个参数一个都不能少 - 关键在于用
logging.error(..., exc_info=(exc_type, exc_value, exc_traceback))传入原始的 traceback,否则日志里只会记最后一行错误信息 - 钩子里尽量不要做可能阻塞或异常的操作,比如网络请求、数据库写入、不加锁的全局变量修改
import sys
import logging
logging.basicConfig(
level=logging.ERROR,
filename="/var/log/myapp/error.log",
format="%(asctime)s %(levelname)s %(message)s",
datefmt="%Y-%m-%d %H:%M:%S"
)
def global_exception_handler(exc_type, exc_value, exc_tb):
logger = logging.getLogger()
logger.error("Uncaught exception", exc_info=(exc_type, exc_value, exc_tb))
sys.excepthook = global_exception_handler
主线程 vs 子线程的异常捕获差异
需要注意一个关键点:sys.excepthook 只对主线程管用。子线程里抛出的未捕获异常,不会触发它,而是直接被静默丢弃——除非你用 Python 3.8 以上版本提供的 threading.excepthook。
- 最稳妥的做法,是在
threading.Thread的run()方法里手动包一层try/except - Python ≥ 3.8:可以设置
threading.excepthook,签名跟sys.excepthook一致,但注意它不会自动继承主线程的 logger 配置,需要自己处理 - 异步任务(比如
asyncio.create_task)同样不走sys.excepthook,得靠asyncio.get_event_loop().set_exception_handler()来兜底
容易被忽略的崩溃场景:信号、fork、atexit
还有一些场景,sys.excepthook 连被调用的机会都没有:
立即学习“Python免费学习笔记(深入)”;
- 像
os.kill(os.getpid(), signal.SIGSEGV)这种强制终止,直接杀死进程,Python 根本没有机会执行任何钩子 os.fork()之后,子进程会复制父进程的excepthook引用,但如果父进程提前重置过,子进程未必能同步——所以建议 fork 之后在子进程里重新设置一遍atexit回调里抛异常?直接被忽略,连个日志都不留——唯一的办法是在回调内部自己try/except+ 主动logging
说到底,真正靠谱的兜底方案从来不是单靠 sys.excepthook。得把进程级监控(比如 systemd 的 Restart=on-failure)、核心转储分析、以及关键路径上的主动防御式日志结合起来,才能做到心里有底。


































