Flask默认日志不写入文件是因为开发服务器仅输出到stderr且未配置文件handler；生产环境日志更易被WSGI接管或丢弃。常见问题包括basicConfig失效、日志仅显示在终端、重启后文件为空及多进程错乱。根本原因是app.logger是独立实例，不继承root logger配置，且Flask启动时已添加StreamHandler，basicConfig仅在root无handler时生效；同时若未显式设置日志级别，WARNING以下消息会被过滤。可靠写法是直接为app.logger添加RotatingFileHandler，指定maxBytes和backupCount防止单文件过大，并调用app.logger.setLevel()确保所需级别日志不被拦截。未捕获异常需通过@app.errorhandler(Exception)配合exc_info=True记录完整traceback。生产环境须用绝对路径并确保运行用户有写权限，避免写入只读源码目录。
Flask 默认日志为什么写不到文件里
因为 Flask 开发服务器（app.run()）默认只把日志输出到 stderr，不自动配置文件 handler；生产环境用 WSGI（如 Gunicorn）时，日志更可能被完全接管或丢弃。
常见错误现象：logging.basicConfig(filename=...) 不生效、日志只在终端刷、重启后文件为空、多进程下日志错乱。
- Flask 的
app.logger是独立 logger 实例，不继承 root logger 配置 -
basicConfig()只在 root logger 未配置 handler 时生效，而 Flask 启动时已加了 StreamHandler - 没设日志级别，
WARNING以下（比如INFO或ERROR）消息直接被过滤
给 Flask 应用加文件日志的最小可靠写法
直接操作 app.logger，添加 RotatingFileHandler，并确保级别放开：
import logging
from logging.handlers import RotatingFileHandler
handler = RotatingFileHandler('app.log', maxBytes=10*1024*1024, backupCount=5)
handler.setLevel(logging.ERROR)
handler.setFormatter(logging.Formatter(
'%(asctime)s %(levelname)s %(name)s %(message)s'
))
app.logger.addHandler(handler)
app.logger.setLevel(logging.ERROR)
- 必须调用
app.logger.addHandler()，不能只配 root logger -
maxBytes=10*1024*1024防止单个日志文件无限增长（10MB） -
backupCount=5表示最多保留 5 个历史轮转文件 - 别漏掉
app.logger.setLevel()—— Flask 默认是WARNING，ERROR日志才能过这一关
捕获未处理异常并写入错误日志
Flask 的 app.logger.error() 不会自动记录未捕获异常；要真正“记下崩溃”，得靠 @app.errorhandler(Exception) 或中间件。
最稳妥的做法是注册全局异常处理器：
@app.errorhandler(Exception)
def handle_exception(e):
app.logger.error('Unhandled Exception', exc_info=True)
return 'Server Error', 500
-
exc_info=True是关键，它让 traceback 写进日志，否则只有错误类型和消息 - 别在 handler 里用
print()或裸logger.error(str(e))，会丢堆栈 - 如果用了蓝本（Blueprint），这个 handler 仍全局有效；但若用 Gunicorn，还需确认其
--capture-output是否开启，否则 stderr 日志可能被截断
生产环境要注意的权限与路径问题
日志路径不是当前工作目录，而是运行 WSGI 进程的用户视角下的路径 —— 很多时候 app.log 会写到 / 根目录或 /var/www 下，然后因权限失败静默丢弃。
- 务必用绝对路径，比如
/var/log/myapp/app.log，并提前chown www-data:www-data /var/log/myapp - 检查运行用户（如
gunicorn的--user参数）是否有该路径的写权限 - 避免把日志写进 Flask 项目源码目录 —— 容器或部署工具可能挂载只读卷，导致 handler 初始化就抛
PermissionError - Windows 下路径分隔符不用特别处理，
RotatingFileHandler兼容正斜杠
最常被忽略的一点：handler 添加后不会自动 flush，极端情况下（如进程被 kill -9）最后一段日志可能丢失；真要强一致性，得设 delay=False 和手动 handler.flush()，但通常不必要。
