0

0

Python 多进程环境下的日志处理方案

冷炫風刃

冷炫風刃

发布时间:2026-02-19 17:21:10

|

703人浏览过

|

来源于php中文网

原创

根本原因是python默认filehandler和streamhandler非进程安全,多进程并发写同一文件或stdout会导致乱序、丢日志;应使用queuehandler+queuelistener方案实现跨进程安全日志。

python 多进程环境下的日志处理方案

多进程里 logging 一用就乱序、丢日志,根本原因是什么

不是日志写错了,是 Python 默认的 FileHandlerStreamHandler 不是进程安全的。多个子进程同时往同一个文件或 stdout 写日志时,会抢锁失败、缓冲区错位、甚至覆盖彼此内容——尤其在高并发写小日志时,OSError: [Errno 9] Bad file descriptor 或空行、截断都算轻的。

关键点在于:每个子进程都得有自己独立的日志资源,或者用跨进程安全的同步机制。

  • 别复用主进程创建的 logger 实例,子进程里要重新配置
  • 避免所有进程共用一个 FileHandler 对象(哪怕路径相同也不行)
  • RotatingFileHandler 在多进程下默认不安全,除非配合 delay=True + 外部同步

QueueHandler + QueueListener 是最稳的方案

这是官方推荐的跨进程日志转发模式:每个子进程只往一个 multiprocessing.Queue 发日志;主进程开一个监听线程,统一消费并写入文件。全程无文件竞争,顺序可控,也支持 RotatingFileHandler 等高级功能。

实操要点:

立即学习Python免费学习笔记(深入)”;

ecshop
ecshop

本版本全面兼容php5.6+,并且修复了许多官方程序的低级代码bug。在apache 2.4.17+php5.6.15环境下测试通过,人格保证无毒无木马,仅仅是一名ecshop热爱者心血来潮之作。ecshop编译更新日志:1、加入最新官方补丁。2、修改数据库连接底层为mysqli, 现在完美无缺了。3、再次对所有代码进行细节修复。4、adminers更新至1.1.2, 在线管理数据库的神器。5、测

下载
  • 子进程中必须调用 logging.setLoggerClass(logging.Logger) 重置 logger 类(否则 multiprocessing fork 后可能残留旧状态)
  • 子进程里只加 QueueHandler,别加任何其他 handler
  • 主进程启动 QueueListener 前,确保日志目录已存在,否则 FileHandler 初始化失败会静默吞掉异常
  • 别忘了在主进程退出前调用 queue_listener.stop(),否则子进程可能卡在队列写入上

示例片段(主进程):

queue = multiprocessing.Queue(-1)
queue_handler = logging.handlers.QueueHandler(queue)
logger.addHandler(queue_handler)

queue_listener = logging.handlers.QueueListener(queue, file_handler)
queue_listener.start()

multiprocessing.get_logger() 能不能直接用

能,但只适合调试,别用于生产。它底层用的是 StreamHandler 输出到 stderr,没做任何同步,且返回的 logger 是全局单例——多个子进程写同一 stderr 流,必然乱序。更麻烦的是,它的 level 默认是 WARNING,你调了 setLevel(logging.DEBUG) 也可能被父进程覆盖。

  • 它不支持自定义格式、文件输出、轮转等基本需求
  • 在 Windows 上表现更差(spawn 方式下 logger 实例可能为空)
  • 如果用了 concurrent.futures.ProcessPoolExecutor,它压根不触发 get_logger() 的初始化逻辑

想省事用文件名区分进程?注意命名和清理

给每个子进程配独立日志文件(比如加 os.getpid())确实简单,但容易埋坑:

  • 文件名别只用 pid,加个时间戳或任务 ID,否则重启后 pid 复用导致日志覆盖
  • 大量子进程会产生一堆零散日志文件,得自己实现归档逻辑,TimedRotatingFileHandler 在这种场景下完全失效
  • Windows 下文件句柄限制更紧,开太多 FileHandler 可能触发 OSError: [Errno 24] Too many open files
  • 别在子进程退出时自动删日志文件——万一主进程要合并分析,就找不到了

这法子适合短期脚本或 debug,长期运行的服务必须上 QueueHandler

真正难的不是选哪种方式,是子进程里 logger 的初始化时机和上下文隔离——fork 后不重置 handler、不清理旧 handler 引用,再好的方案也会漏日志。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

419

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

594

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

675

2023.08.10

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1184

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1150

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

820

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

460

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2361

2023.08.08

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

660

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号