Python线程/进程工作器通过Queue传异常保留栈追踪的实现方法

直接通过multiprocessing.Queue传递异常会丢失栈追踪，本质是两个原生限制：

• Python原生traceback栈对象持有执行帧、局部变量等上下文引用，不支持跨进程pickle序列化，强行传递会直接抛出序列化错误
• 线程场景下跨线程传递异常对象时，原异常绑定的栈帧会在离开原执行线程后失效，无法读取到原始栈信息

核心逻辑是在异常产生的工作端提前把栈信息转为可序列化的格式，消费端拿到后还原异常和栈信息，重抛时即可保留完整上下文，方案同时兼容线程、进程两种工作模式。

标准库无依赖方案 #

不需要安装第三方包，适合大多数日志上报、调试场景。
工作端捕获异常时，将异常类型、异常信息、格式化后的完整栈字符串打包入队：

import traceback
from multiprocessing import Queue

def worker(queue: Queue):
    try:
        # 业务逻辑，此处模拟报错
        raise ValueError("业务逻辑执行失败")
    except Exception as e:
        error_pack = {
            "exc_type": type(e),
            "exc_msg": str(e),
            "raw_traceback": traceback.format_exc()
        }
        queue.put(error_pack)

主线程消费队列时，还原异常并附加原始栈信息后抛出：

import sys
from threading import Thread
# 进程场景替换为 from multiprocessing import Process 即可，逻辑完全一致

if __name__ == "__main__":
    q = Queue()
    worker_thread = Thread(target=worker, args=(q,))
    worker_thread.start()
    
    err_pack = q.get()
    worker_thread.join()

    # 先输出原始栈信息保证日志完整
    print(f"捕获工作器异常，原始栈追踪：\n{err_pack['raw_traceback']}", file=sys.stderr)
    # 实例化原始异常抛出
    raise err_pack["exc_type"](err_pack["exc_msg"])

如果使用Python 3.11及以上版本，可以用异常的add_note方法直接把原始栈绑定到异常对象上，不需要单独打印：

err = err_pack["exc_type"](err_pack["exc_msg"])
err.add_note(f"=== 工作器原始栈追踪 ===\n{err_pack['raw_traceback']}")
raise err

原生栈还原方案（需第三方依赖） #

如果需要和本地抛出异常完全一致的栈追踪表现（比如异常会被统一的异常拦截器处理，不希望单独加打印逻辑），可以使用tblib库，它会给traceback对象增加可序列化能力，直接跨队列传递原生栈对象。
首先安装依赖：
pip install tblib

工作端代码：

from tblib import pickling_support
pickling_support.install()  # 注入pickle对traceback的支持

def worker(queue: Queue):
    try:
        raise ValueError("业务逻辑执行失败")
    except Exception as e:
        # 异常类型、异常对象、栈对象都可直接序列化入队
        queue.put((type(e), e, e.__traceback__))

消费端代码：

if __name__ == "__main__":
    q = Queue()
    worker_thread = Thread(target=worker, args=(q,))
    worker_thread.start()
    
    exc_type, exc, tb = q.get()
    worker_thread.join()

    # 绑定原始栈后直接抛出，和工作器内直接抛异常的栈表现完全一致
    raise exc.with_traceback(tb)

• 两种方案都不需要针对线程、进程模式写分支逻辑，切换工作器类型时直接替换导入的类即可
• 标准库方案兼容性最强，支持所有Python3版本，满足绝大多数错误排查、日志上报需求
• tblib方案的栈表现和原生异常完全一致，适合框架类、通用组件类场景使用

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