flask默认不记录日志到文件，需手动配置logging：添加filehandler（推荐rotatingfilehandler）和streamhandler，统一设level为info，并禁用gunicorn冲突输出；模块日志应按功能命名如'app.models'以精准定位。
Flask默认不记录日志到文件，必须手动配置logging模块
Flask开发时，app.logger默认只输出到stderr（控制台），且级别固定为WARNING。本地调试可能够用，但部署后没文件日志就等于失明——错误无法追溯，请求无迹可寻。
关键点在于：不能只调用app.logger.info()就以为万事大吉；必须显式添加FileHandler并设置Formatter，否则日志永远进不了文件。
- Flask的
app.logger本质是logging.getLogger('flask.app')，它继承自根logger，但默认没有handler - 直接写
logging.info()会走根logger，和app.logger不是一回事，容易混乱 - 多进程部署（如gunicorn）时，多个worker同时写同一日志文件会损坏内容，需用
RotatingFileHandler或TimedRotatingFileHandler
如何让INFO及以上日志同时输出到控制台和文件
常见需求是开发时看console、上线后查文件，且要保留DEBUG/INFO/ERROR分级。核心是给app.logger添加两个handler，并统一设置level为INFO（否则INFO消息可能被过滤掉）。
import logging
from logging.handlers import RotatingFileHandler
<p>if not app.debug:</p><h1>文件处理器：按大小轮转，最多5个备份</h1><pre class="brush:python;toolbar:false;">file_handler = RotatingFileHandler(
'logs/app.log',
maxBytes=10 * 1024 * 1024, # 10MB
backupCount=5
)
file_handler.setLevel(logging.INFO)
file_handler.setFormatter(logging.Formatter(
'%(asctime)s %(levelname)s %(name)s %(message)s'
))
app.logger.addHandler(file_handler)控制台处理器（始终启用）
stream_handler = logging.StreamHandler() stream_handler.setLevel(logging.INFO) stream_handler.setFormatter(logging.Formatter( '%(levelname)s - %(message)s' )) app.logger.addHandler(stream_handler)
确保app.logger最低接收INFO级
app.logger.setLevel(logging.INFO)
注意：app.logger.setLevel()必须设为INFO或更低，否则即使handler设了INFO，logger自身也会拦截掉INFO消息。
gunicorn部署时日志丢失或重复的根源
用gunicorn --log-level info启动后，发现日志既在终端重复刷屏，又没进app.log——这是典型的手动handler与gunicorn内置日志冲突。
根本原因：gunicorn会接管sys.stdout/sys.stderr，并把Flask的StreamHandler重定向到自己的日志流；同时，若未禁用gunicorn的access log，每个HTTP请求还会额外打一行access日志，造成冗余。
- 解决方法一：部署时关闭
StreamHandler，只留RotatingFileHandler，靠gunicorn的--access-logfile和--error-logfile管好访问和错误日志 - 解决方法二：在gunicorn配置中设
capture_output=True，并确保Flask不向stdout写日志（即删掉StreamHandler） - 绝对不要在
if __name__ == '__main__':里配日志——gunicorn不走这个分支，配置无效
如何给不同模块打不同前缀的日志（比如数据库操作单独标记）
单纯用app.logger会导致所有日志都标着flask.app，查问题时分不清是路由逻辑还是SQL执行出错。正确做法是按模块名获取独立logger：
# 在models.py里
logger = logging.getLogger('app.models')
logger.info('Query executed') # 输出：INFO:app.models:Query executed
<h1>在views.py里</h1><p>logger = logging.getLogger('app.views')
logger.error('User not found') # 输出：ERROR:app.views:User not found</p>
这样做的好处是：既能统一由app.logger的handler接管（只要父logger配置了propagate=True），又能通过日志名快速过滤定位。注意别写成logging.getLogger(__name__)——如果模块路径含点（如app.views.auth），日志名会过长，建议手动指定简洁名。
分级输出真正起作用的地方，往往不在格式多炫，而在你能否在凌晨三点精准grep出那条ERROR:app.database而不是在一堆flask.app里翻半小时。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
