Flask默认日志不支持按天滚动,须替换为TimedRotatingFileHandler并清空原有handlers;需显式设置level,且要单独配置werkzeug logger;多进程下应使用ConcurrentRotatingFileHandler或进程隔离日志文件。

Flask默认日志不支持按天滚动,必须替换Handler
Flask自带的app.logger底层用的是Python标准logging模块,但默认配置的是StreamHandler,只输出到控制台,完全不支持文件切分。想按天生成app.log.2024-05-20这类文件,必须手动替换为TimedRotatingFileHandler,且不能依赖app.logger.addHandler()简单追加——否则会和Flask内置的StreamHandler冲突,导致日志重复输出。
常见错误现象:app.log文件没按天切分、日志内容重复出现两次、凌晨切换时丢失部分日志。
- 务必在
app.logger.handlers.clear()后重建整个日志链路 -
TimedRotatingFileHandler的when='midnight'是唯一可靠按天切分的方式,when='D'已被弃用且行为不稳定 - 设置
backupCount=7可自动保留最近7天日志,避免磁盘占满
如何避免多进程下日志写入冲突?
用gunicorn或uWSGI部署时,多个worker进程会同时尝试写同一个日志文件,造成内容错乱甚至损坏。标准TimedRotatingFileHandler不处理进程安全问题。
解决路径只有两个:
- 改用
ConcurrentRotatingFileHandler(需pip install ConcurrentLogHandler),它内部用文件锁保证安全,配置方式和原生Handler基本一致 - 或者让每个worker写独立日志文件,例如在
filename中加入os.getpid(),但这样就失去了“统一按天归档”的意义
注意:RotatingFileHandler和TimedRotatingFileHandler都不支持多进程,强行使用会出现日志截断、覆盖、乱序等问题。
为什么不能直接用logging.basicConfig()?
Flask初始化后,basicConfig()就失效了——因为logging模块的根logger一旦被配置过(Flask启动时已触发),后续调用basicConfig()直接静默返回,不会生效。这是最常被忽略的坑。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
正确做法是直接操作app.logger实例:
import logging
from logging.handlers import TimedRotatingFileHandler
handler = TimedRotatingFileHandler(
filename='logs/app.log',
when='midnight',
interval=1,
backupCount=7,
encoding='utf-8'
)
handler.setFormatter(logging.Formatter(
'%(asctime)s %(levelname)s %(name)s %(message)s'
))
app.logger.handlers.clear()
app.logger.addHandler(handler)
app.logger.setLevel(logging.INFO)
关键点:app.logger.setLevel()必须显式设置,否则默认是WARNING,INFO级别日志不会写入文件。
如何让werkzeug访问日志也进同一个滚动文件?
Flask自身日志(如app.logger.info())可以接管,但HTTP请求日志来自werkzeug,它用的是独立的logging.getLogger('werkzeug'),默认仍输出到控制台。
要统一归档,必须单独配置该logger:
- 获取
logging.getLogger('werkzeug'),清空其handlers - 复用上面创建的
TimedRotatingFileHandler或新建一个(推荐复用,避免文件句柄过多) - 注意:werkzeug日志格式较简单,可用
%(asctime)s %(message)s,无需%(name)s
如果用了ConcurrentRotatingFileHandler,记得给werkzeug logger也配同一个handler实例,否则多进程下可能打开过多文件描述符。
Flask日志按天滚动真正难的不是代码几行,而是理清三个logger的关系:app.logger、root logger、werkzeug logger,以及多进程场景下handler的线程/进程安全性边界。漏掉任意一环,都会导致日志缺失、重复或损坏。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










