Flask日志初始化、请求日志格式修改及服务器关闭回调问题咨询

I. Flask应用日志初始化的准确位置 #

日志初始化应该放在app = Flask(__name__)之后。

原因很明确：Flask的日志系统与应用实例绑定，app.logger是当前应用的专属日志对象。如果在实例化app前配置日志，操作的是Python全局root logger，无法精准控制Flask应用自身的日志行为，且Flask初始化时可能覆盖部分全局日志配置。

正确示例：

from flask import Flask
import logging

# 先实例化Flask应用
app = Flask(__name__)

# 再配置应用专属日志
app.logger.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
handler = logging.FileHandler('app.log')
handler.setFormatter(formatter)
app.logger.addHandler(handler)

II. 自定义HTTP请求日志格式 #

Flask的请求日志由底层Werkzeug服务器处理，要实现目标格式，最灵活的方式是重写Werkzeug的WSGIRequestHandler类，替换日志记录逻辑：

from flask import Flask
from werkzeug.serving import WSGIRequestHandler

app = Flask(__name__)

# 自定义请求处理器，重写日志方法
class CustomRequestLogger(WSGIRequestHandler):
    def log(self, log_type, message, *args):
        # 仅处理请求类型日志
        if log_type == 'request':
            # 解析请求行信息
            method, path, _ = args[0].split()
            # 获取请求头参数
            client_ip = self.address_string()
            content_type = self.headers.get('Content-Type', '未指定')
            content_length = self.headers.get('Content-Length', '0')
            user_agent = self.headers.get('User-Agent', '未指定')
            
            # 按目标格式输出日志
            custom_log = (f'Received {method} request "{path}" from IP {client_ip}.'
                         f' Content-Type = "{content_type}", Content-Length = {content_length}, User-Agent = "{user_agent}"')
            app.logger.info(custom_log)
        else:
            # 其他类型日志沿用默认逻辑
            super().log(log_type, message, *args)

# 启动服务器时指定自定义处理器
if __name__ == '__main__':
    app.run(request_handler=CustomRequestLogger)

启动应用后，所有HTTP请求都会按照你需要的格式记录日志。

III. 内置开发服务器注册关闭处理器 #

Flask内置开发服务器支持注册关闭时的清理操作，核心是通过Python的signal模块捕获SIGINT信号（即按下Ctrl+C触发的信号），在信号处理器中执行清理逻辑：

import signal
from flask import Flask

app = Flask(__name__)

def server_cleanup(signum, frame):
    # 在这里编写清理逻辑：关闭数据库连接、临时文件清理、状态保存等
    print("服务器即将关闭，执行清理操作...")
    exit(0)

# 注册SIGINT信号处理器
signal.signal(signal.SIGINT, server_cleanup)

@app.route('/')
def home():
    return "Hello, Flask!"

if __name__ == '__main__':
    app.run()

按下Ctrl+C终止服务器时，server_cleanup函数会被触发，执行你定义的清理操作。

注意：teardown_appcontext用于每个请求结束后的资源清理，并非服务器关闭时的全局清理，不要混淆两者场景。

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