如何排查Python模块中sys.stderr输出未达预期位置的问题

我正在开发一个Python模块，其中部分函数会将stdout和stderr输出到自定义日志文件。示例代码如下：

示例代码 #

module_ex.py #

import sys

def testfunc(errfile):
    sys.stdout = open('stdout.file', "w")
    sys.stderr = open(errfile, "w")

    print(str(2) + " " + "Hello")
    print(2 + " " + "Hello")
    return

script.py #

#!/usr/bin/env python
import module_ex as mdx
mdx.testfunc("error.log")

运行命令 #

python script.py

在这个示例中，sys.stderr被重定向到error.log的行为符合预期，但我的模块中有时错误消息并未出现在预期的日志文件中。我怀疑这是与其他库冲突，或是之前的sys.stderr声明仍在生效，导致它指向了意外位置。请问能否在模块的特定函数内验证sys.stderr的指向位置？比如打印sys.stdout对应的文件路径，也就是如何追踪stderr的输出位置？

解决方案 #

1. 直接打印文件对象的name属性 #

当你把sys.stderr赋值为一个打开的文件对象时，可通过访问该对象的name属性获取对应文件路径：

def testfunc(errfile):
    sys.stderr = open(errfile, "w")
    # 将验证信息输出到原始stderr（避免被重定向覆盖）
    print(f"当前sys.stderr指向的文件: {sys.stderr.name}", file=sys.__stderr__)

    print(str(2) + " " + "Hello")
    print(2 + " " + "Hello")
    return

这里sys.__stderr__是Python保留的原始标准错误流，能确保验证信息直接在终端显示，不受你的重定向逻辑影响。

2. 获取真实文件路径（处理软链接） #

如果目标路径是软链接，可通过os.path.realpath获取实际指向的文件：

import os

def testfunc(errfile):
    sys.stderr = open(errfile, "w")
    real_path = os.path.realpath(sys.stderr.name)
    print(f"sys.stderr真实文件路径: {real_path}", file=sys.__stderr__)

    # 后续业务逻辑...

3. 测试错误输出是否生效 #

主动触发异常并写入stderr，验证内容是否进入目标文件：

def testfunc(errfile):
    sys.stderr = open(errfile, "w")
    print(f"当前stderr路径: {sys.stderr.name}", file=sys.__stderr__)
    try:
        # 触发类型错误
        print(2 + " " + "Hello")
    except Exception as e:
        sys.stderr.write(f"测试错误: {str(e)}\n")
        # 强制刷新缓冲区，避免内容滞留
        sys.stderr.flush()
    return

执行后检查目标日志文件是否存在"测试错误"的内容，结合路径打印确认指向是否正确。

额外建议：避免全局重定向冲突 #

为防止其他库修改sys.stderr引发冲突，建议函数执行完成后恢复原始stderr：

def testfunc(errfile):
    # 保存原始stderr
    original_stderr = sys.stderr
    try:
        sys.stderr = open(errfile, "w")
        print(f"当前stderr路径: {sys.stderr.name}", file=original_stderr)
        # 业务逻辑
        print(str(2) + " " + "Hello")
        print(2 + " " + "Hello")
    finally:
        # 关闭重定向的文件
        sys.stderr.close()
        # 恢复原始stderr
        sys.stderr = original_stderr

这种方式能确保你的函数不会永久修改全局sys.stderr，大幅降低与其他库的冲突概率。

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