Python如何将完整报错写入日志且无需大量try-except块？

你之前的写法只能拿到简短错误文本，核心原因是直接对异常对象做字符串转换时，只会返回异常的描述信息，不会携带错误类型、调用栈、出错行位置这些上下文。下面的实现可以同时满足你的两个诉求，不需要给业务代码加大量try/except块，也能自动记录完整报错栈。

第一步：配置全局日志与异常自动捕获 #

直接用Python标准库实现，不需要安装第三方依赖：

import logging
import sys

# 配置日志输出规则，错误日志直接写入指定文件
logging.basicConfig(
    level=logging.ERROR,
    filename="task_runtime.log",
    format="%(asctime)s - %(levelname)s - %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S",
    encoding="utf-8"
)

# 定义全局异常处理逻辑
def handle_uncaught_exception(exc_type, exc_value, exc_traceback):
    # 放行键盘中断类的正常退出操作，不记录日志
    if issubclass(exc_type, KeyboardInterrupt):
        sys.__excepthook__(exc_type, exc_value, exc_traceback)
        return
    # 自动写入完整异常栈，和控制台输出的报错内容完全一致
    logging.error(
        "任务运行异常",
        exc_info=(exc_type, exc_value, exc_traceback)
    )

# 注册全局异常钩子
sys.excepthook = handle_uncaught_exception

第二步：业务代码无侵入适配 #

注册完上述逻辑后，你所有的业务代码、定时任务逻辑都不需要额外包裹try/except块，也不需要调整原有代码缩进，只要直接运行原有逻辑即可：

# 以下是你的原有业务代码，不需要做任何修改
def scheduled_job():
    # 定时任务的所有逻辑直接写在这里
    printf("GeeksforGeeks")

if __name__ == "__main__":
    scheduled_job()

运行后打开task_runtime.log文件，就能看到包含报错时间、错误类型、完整调用栈、具体出错位置的全量错误信息，和你去掉异常包裹时在控制台/Jupyter看到的报错内容完全一致。

特殊场景适配 #

• 如果你在Jupyter环境使用，需要额外注册ipykernel的异常钩子才能让全局捕获生效，追加以下代码即可：

def handle_ipython_exception(shell, exc_type, exc_value, exc_tb, tb_offset=None):
    logging.error(
        "运行异常",
        exc_info=(exc_type, exc_value, exc_tb)
    )
    # 保留Jupyter原有的红字报错输出，不影响交互体验
    shell.showtraceback((exc_type, exc_value, exc_tb), tb_offset=tb_offset)

get_ipython().set_custom_exc((Exception,), handle_ipython_exception)

• 如果你使用APScheduler、Celery这类定时任务框架，只需要把上述logging.error(...)的逻辑写到框架提供的全局异常回调接口中即可，同样不需要修改业务代码。
• 如果你确实需要在个别位置手动加try/except做特殊处理，只需要在except块中调用logging.exception("自定义错误说明")，就会自动把当前的完整异常栈写入日志，不需要手动操作文件读写。

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