如何让Flask各子应用写入独立日志文件？

核心思路 #

给每个子应用的Flask实例配置专属日志处理器，清除默认的共享处理器，保证日志仅写入对应子应用的日志文件，避免跨应用日志干扰。

分步实现 #

1. 初始化日志目录 #

先确保logs目录存在，防止因目录缺失导致日志无法写入：

import os

logs_dir = "logs"
os.makedirs(logs_dir, exist_ok=True)

2. 子应用日志配置（以my_app1.py为例） #

在每个子应用文件中，单独配置该Flask实例的日志系统：

from flask import Flask
import logging
from logging.handlers import FileHandler

# 初始化子应用Flask实例
app = Flask(__name__)
app.config.from_object("my_app1_config")

# 清除默认日志处理器，避免与主应用/其他子应用共享
for handler in app.logger.handlers[:]:
    app.logger.removeHandler(handler)

# 创建专属文件处理器
file_handler = FileHandler("logs/my_app1.log", encoding="utf-8")
log_formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
file_handler.setFormatter(log_formatter)

# 绑定处理器并设置日志级别
app.logger.addHandler(file_handler)
app.logger.setLevel(logging.INFO)

# 定义Blueprint并注册路由
my_app1_page = app.blueprint("my_app1_page", __name__)

@my_app1_page.route("/")
def app1_index():
    app.logger.info("my_app1 首页被访问")  # 日志将写入logs/my_app1.log
    return "my_app1 Home"

复制上述逻辑到my_app2.py，仅需将日志路径改为logs/my_app2.log即可。

3. 主应用main.py配置 #

主应用仅负责注册子应用的Blueprint，不要修改子应用的日志配置：

from flask import Flask
from my_app1 import my_app1_page
from my_app2 import my_app2_page

app = Flask(__name__)

# 注册子应用路由前缀
app.register_blueprint(my_app1_page, url_prefix="/app1")
app.register_blueprint(my_app2_page, url_prefix="/app2")

if __name__ == "__main__":
    app.run(debug=True)

问题排查 #

• 权限问题：确认运行Flask的用户对logs目录有读写权限，Linux/macOS可执行chmod 755 logs调整。
• 日志级别不匹配：如果调用app.logger.debug()但设置了setLevel(logging.INFO)，调试日志不会写入，需调整级别一致。
• 处理器未清除：若未删除默认处理器，日志可能被主应用的控制台处理器捕获，无法写入文件。

内容的提问来源于stack exchange，提问作者Eddi