如何实现Python faulthandler同时输出到stderr与日志文件

完全可以实现faulthandler同时向stderr和日志文件输出，以下是兼容GNU/Linux、Windows、MacOS三个平台的稳妥实现，不需要依赖任何第三方库，适配Python 3.10版本。

实现原理 #

faulthandler 是在C层直接向传入的文件描述符写入内容，触发段错误时Python解释器本身可能处于异常状态，无法执行Python层自定义的write方法做转发，因此自定义带双写逻辑的类文件对象直接传给faulthandler.enable()是无效的。
可行的跨平台方案是用操作系统提供的管道做中转：

• 创建一对连通的管道文件描述符，将写端传给faulthandler，所有异常栈信息会先写入管道
• 启动一个独立的守护线程，持续从管道读端读取内容，同时写入stderr和目标日志文件
  这种方案不依赖段错误发生时的Python解释器状态，稳定性足够满足调试需求。

可直接复用的代码 #

import os
import sys
import faulthandler
import threading

def enable_faulthandler_dual_output(log_path: str):
    # 创建跨平台可用的管道：r_fd为读端、w_fd为写端
    r_fd, w_fd = os.pipe()
    # 打开日志文件，使用行缓冲保证内容及时落盘
    log_file = open(log_path, "a", encoding="utf-8", buffering=1)

    def _forward_worker():
        while True:
            # 阻塞读取管道内容，每次最多读4KB
            data = os.read(r_fd, 4096)
            if not data:
                break
            # 转发到stderr
            os.write(sys.stderr.fileno(), data)
            # 转发到日志文件
            log_file.write(data.decode("utf-8", errors="replace"))
            log_file.flush()

    # 启动守护线程，程序退出时自动回收，不会阻塞主进程
    forward_thread = threading.Thread(target=_forward_worker, daemon=True)
    forward_thread.start()

    # 将管道写端交给faulthandler
    faulthandler.enable(w_fd)

使用时直接调用该函数传入日志路径即可，替换原有直接打开文件传参给faulthandler.enable()的逻辑：

# 原有逻辑替换为这行即可
enable_faulthandler_dual_output(log_path)

注意事项 #

• 段错误触发时输出的栈追踪内容通常只有几KB，操作系统默认的管道缓冲区大小完全足够承载，不会出现内容丢失的问题
• 所有用到的接口都是Python标准库封装的跨平台系统调用，三个目标操作系统下均可正常运行
• 守护线程不会干扰主程序的正常退出逻辑，不需要手动做线程回收处理

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