Flask本身不提供日志轮转功能,应使用RotatingFileHandler按大小(如10MB)或TimedRotatingFileHandler按天(when='midnight')滚动日志,需清空app.logger.handlers、设level和werkzeug过滤器,并确保日志目录权限正确。

Flask本身不提供日志轮转功能,logrotate 是系统级工具,不能直接“配置在 Flask 中”——你真正要做的,是在 Flask 使用的 Python logging 模块基础上,避免与 logrotate 冲突,并确保轮转后 Flask 仍能写入新日志文件。
为什么不能让 Flask 直接配合 logrotate 自动重开文件
当 logrotate 执行 mv access.log access.log.1 后,Python 的 FileHandler 仍持有原文件描述符(fd),继续往已重命名的文件里写——导致日志“消失”或写进旧归档文件。这是最常踩的坑。
-
logrotate默认不通知应用重载文件句柄,它只管文件系统操作 - Flask 用
logging.FileHandler或RotatingFileHandler时,若没做额外处理,完全感知不到logrotate的动作 - 使用
copytruncate能缓解,但有丢失最后一小段日志的风险(写入中被截断)
推荐做法:用 logging.handlers.RotatingFileHandler 替代 logrotate
除非你有集中日志审计、磁盘配额强管控等运维侧硬性要求,否则优先用 Python 原生轮转——更可控、无竞态、无需依赖系统配置。
- 设置
maxBytes=10485760(10MB)、backupCount=5,自动保留最近 5 个轮转文件 - 避免使用
TimedRotatingFileHandler:它在多进程下(如 gunicorn 多 worker)会冲突,多个进程同时尝试 rename 导致 OSError - 示例初始化方式:
import logging from logging.handlers import RotatingFileHandler <p>handler = RotatingFileHandler( 'flask_app.log', maxBytes=10 <em> 1024 </em> 1024, # 10MB backupCount=5, encoding='utf-8' ) handler.setLevel(logging.INFO) app.logger.addHandler(handler)</p>
必须用 logrotate 时:启用 copytruncate + 配合 reopen 信号(仅限 Gunicorn)
如果你的部署环境强制要求统一用 logrotate(例如 Kubernetes sidecar 日志采集、安全合规策略),那得让 WSGI 服务器支持日志文件重载。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
- 仅
gunicorn支持SIGHUP重载配置并重新打开日志文件;uWSGI用--touch-reload,而纯flask run不支持 -
logrotate配置里必须加copytruncate和postrotate发送信号:
/var/log/myapp/*.log {
daily
missingok
rotate 30
compress
copytruncate
postrotate
/bin/kill -s SIGHUP $(cat /var/run/gunicorn.pid 2>/dev/null) 2>/dev/null || true
endscript
}
- 注意:
copytruncate不是原子操作,高并发写入时可能丢几行日志 - 确保 gunicorn 启动时用了
--pid /var/run/gunicorn.pid,且该路径可被logrotate进程读取
Flask 日志路径和权限问题(生产环境高频报错)
常见错误信息:PermissionError: [Errno 13] Permission denied: 'app.log' 或 OSError: [Errno 2] No such file or directory。
- Flask 进程用户(如
www-data)必须对日志目录有w+ x权限(不是仅对文件)——因为RotatingFileHandler需要在同目录下创建新文件 - 不要把日志写到
/var/log/myapp/却只给了文件权限,忘了chown www-data:www-data /var/log/myapp - 避免用相对路径(如
'logs/app.log'),生产环境一律用绝对路径,比如'/var/log/myapp/app.log' - 若用 systemd 管理 gunicorn,检查
RuntimeDirectory=和LogsDirectory=是否已声明,否则目录可能被自动清理
真正的难点不在配置语法,而在于确认日志写入路径、进程身份、文件系统权限、轮转触发时机这四者的实时一致性——任何一个环节脱节,日志就会静默丢失,且很难复现。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










