Python如何捕获所有未处理的异常并记录日志_通过sys.excepthook

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）、核心转储分析、以及关键路径上的主动防御式日志结合起来，才能做到心里有底。