PyInstaller编译后如何将stderr重定向至日志文件？

问题场景 #

• 用PyInstaller编译Python项目时，不加-w参数崩溃会显示带行号的错误，但控制台瞬间关闭，无法查看完整信息
• 在主方法前添加了stdout/stderr重定向到日志文件的代码，PyCharm中运行正常，但编译成exe后仅能创建空日志文件，无任何内容
• 尝试过加-w和不加-w两种编译命令，日志均为空；不加-w时控制台仍能看到错误，说明重定向逻辑未生效

重定向代码 #

if sys.platform == "win32":
    date_time_obj = datetime.now()
    timestamp_str = date_time_obj.strftime("%d-%b-%Y_%H_%M_%S")
    filename = './Log/crash-{}.log'.format(timestamp_str)
    sys.stdout = open(filename, 'w')
    sys.stderr = sys.stdout

编译命令 #

# 不加-w参数
pyinstaller main.py --name Software --log-level DEBUG --icon=resources\Icon.png 2> build.txt

# 加-w参数
pyinstaller main.py --name Software --log-level DEBUG -w --icon=resources\Icon.png 2> build.txt

原因分析 #

PyInstaller编译后的Windows exe，stdout/stderr的底层处理机制和原生Python环境不同。直接替换sys.stdout/sys.stderr的方式，要么是重定向时机太晚（崩溃发生在代码执行前），要么是无法覆盖exe实际使用的输出流，导致错误信息没被写入日志。

解决方案 #

方法1：用logging模块替代直接重定向 #

logging模块兼容性更强，能确保所有输出（包括第三方库的报错）都被捕获，同时支持多输出目标：

import logging
import sys
from datetime import datetime
import os

if sys.platform == "win32":
    # 确保Log目录存在，避免创建文件失败
    log_dir = './Log'
    os.makedirs(log_dir, exist_ok=True)
    
    timestamp_str = datetime.now().strftime("%d-%b-%Y_%H_%M_%S")
    log_filename = os.path.join(log_dir, f'crash-{timestamp_str}.log')
    
    # 配置logging：同时输出到文件和控制台（不加-w时能看到）
    logging.basicConfig(
        level=logging.DEBUG,
        format='%(asctime)s - %(levelname)s - %(message)s',
        handlers=[
            logging.FileHandler(log_filename, encoding='utf-8'),
            logging.StreamHandler(sys.stdout)
        ]
    )
    
    # 将sys.stdout/stderr重定向到logging，覆盖所有输出
    class StreamToLogger:
        def __init__(self, logger, log_level):
            self.logger = logger
            self.log_level = log_level
            self.linebuf = ''

        def write(self, buf):
            for line in buf.rstrip().splitlines():
                self.logger.log(self.log_level, line.rstrip())

        def flush(self):
            pass

    sys.stdout = StreamToLogger(logging.getLogger('STDOUT'), logging.INFO)
    sys.stderr = StreamToLogger(logging.getLogger('STDERR'), logging.ERROR)

方法2：用try-except包裹主逻辑，确保崩溃被捕获 #

如果崩溃发生在重定向代码之后，把主逻辑放在try块里，强制将错误写入日志：

import sys
from datetime import datetime
import os
import traceback

def main():
    # 你的主程序逻辑写在这里
    raise Exception("测试崩溃场景")

if __name__ == "__main__":
    if sys.platform == "win32":
        log_dir = './Log'
        os.makedirs(log_dir, exist_ok=True)
        timestamp_str = datetime.now().strftime("%d-%b-%Y_%H_%M_%S")
        log_path = os.path.join(log_dir, f'crash-{timestamp_str}.log')
        
        with open(log_path, 'w', encoding='utf-8') as log_file:
            # 临时替换标准流
            original_stdout = sys.stdout
            original_stderr = sys.stderr
            sys.stdout = log_file
            sys.stderr = log_file
            
            try:
                main()
            except Exception:
                # 打印完整堆栈信息
                traceback.print_exc()
                # 强制刷新缓冲区，确保内容写入文件
                log_file.flush()
            finally:
                # 恢复标准流
                sys.stdout = original_stdout
                sys.stderr = original_stderr
    else:
        main()

方法3：临时查看错误的快捷方式 #

如果只是临时排查问题，不需要日志文件，可以：

• 打开命令提示符，切换到exe所在目录，直接运行Software.exe，控制台不会自动关闭，错误信息会保留在窗口中
• 或者在主逻辑最后添加input("按回车键关闭...")，但这种方式仅适用于程序正常结束的情况，崩溃时可能不会执行到

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