讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在Python中利用Flask钩子函数记录接口请求耗时?

夏敏同学_1802

夏敏同学_1802

发布时间:2026-09-30 06:40:19

|

489人浏览过

|

来源于php中文网

原创

最稳妥方案是用 before_request 记录起始时间到 g 对象,after_request 读取并计算耗时,精确覆盖路由执行及响应处理全过程;异常时需用 teardown_request 兜底,日志须包含方法、路径、状态码等上下文。

如何在python中利用flask钩子函数记录接口请求耗时?

用 before_request 和 after_request 配合记录耗时最稳妥

Flask 没有现成的“请求耗时钩子”,但 before_request 和 after_request 足够精确——前者在路由函数执行前触发,后者在响应生成后、发送前触发,中间时间差就是真实处理耗时(不含网络传输)。

常见错误是只用 before_request + 全局变量存开始时间,却在视图函数里手动计算,这会漏掉 after_request 中的逻辑(比如 header 注入、日志格式化);或者误用 teardown_request,它可能在异常未捕获时才触发,导致耗时统计不全。

  • 务必在 before_request 中用 g(Flask 的请求上下文对象)存起始时间:
    from flask import g
    import time
    <p>@app.before_request
    def record_start_time():
    g.start_time = time.time()
  • after_request 中读取并计算:
    @app.after_request
    def record_response_time(response):
        if hasattr(g, 'start_time'):
            elapsed = time.time() - g.start_time
            app.logger.info(f"Request to {request.endpoint} took {elapsed:.3f}s")
        return response
  • 注意:如果视图函数抛出异常且未被捕获,after_request 不会执行,此时需配合 teardown_request 补充记录(但仅用于兜底,不替代主逻辑)

用 flask-talisman 或自定义装饰器会破坏请求链路

有人想给每个视图函数加装饰器(比如 @measure_time),看似灵活,但实际绕过了 Flask 的中间件机制,无法统一覆盖静态文件、错误处理器(@app.errorhandler)、甚至蓝图中未显式装饰的端点。更麻烦的是,装饰器嵌套顺序容易和 login_required 等其他装饰器冲突,导致耗时统计值偏小(只测了业务逻辑,漏了权限校验)。

flask-talisman 是安全加固库,和耗时无关;强行塞进它的钩子里不仅语义错乱,还会因它内部重写响应而干扰时间测量点。

立即学习“Python免费学习笔记(深入)”;

Python Use Agent
Python Use Agent

智能执行Python任务,自动生成、执行代码并反馈结果,无需额外配置,兼容旧命令。

下载
  • 不要用装饰器替代钩子——除非你明确只要测某几个接口,且能保证所有调用路径都被装饰
  • 避免在 before_request 里做耗时操作(如查数据库),否则它本身会被计入总耗时,污染数据
  • 若需区分“业务耗时”和“框架耗时”,可把计时起点往后挪到视图函数第一行(用装饰器),但必须接受统计口径不一致的风险

耗时日志要带关键上下文,否则查问题时等于没记

只记 "took 0.234s" 毫无意义。生产环境必须附带请求方法、路径、状态码、用户标识(如 request.headers.get('X-User-ID'))和 trace_id(如果有分布式追踪)。

  • 推荐日志格式:
    app.logger.info(
        "REQ %s %s %s | %.3fs | status=%d | user=%s | trace=%s",
        request.method,
        request.path,
        request.endpoint,
        elapsed,
        response.status_code,
        request.headers.get('X-User-ID', '-'),
        request.headers.get('X-Trace-ID', '-')
    )
  • 状态码必须从 response.status_code 读,不能用 200 硬编码——否则 404/500 接口的耗时永远显示为成功状态
  • 避免在日志里拼接敏感信息(如完整 token、密码参数),用 request.args.to_dict() 前先过滤键名

异步视图(async def)下 time.time() 仍可用,但要注意事件循环

Flask 2.0+ 支持 async 视图,但 before_request 和 after_request 仍是同步函数。这意味着 g.start_time 在 async 视图中依然准确,因为请求上下文在进入 async 函数前就已建立。

真正的问题在于:如果你在 async 视图里用了 await asyncio.sleep(1) 这类挂起操作,time.time() 测的是 wall-clock 时间(含挂起),符合“用户感知耗时”的需求;但若想排除 I/O 等待,得用 asyncio.get_event_loop().time(),不过 Flask 钩子不支持 await,无法直接用。

  • 结论:保持用 time.time(),它对 async 视图也有效,且结果更贴近真实体验
  • 不要试图在 before_request 里 await 任何东西——Flask 会报错,钩子必须是同步的
  • 如果项目重度依赖异步(如大量 HTTP client 调用),考虑迁移到 FastAPI,它的中间件原生支持 async

Flask 的耗时统计难点不在代码量,而在钩子执行时机与请求生命周期的咬合精度——尤其当项目引入蓝图、错误处理器、WSGI 中间件后,after_request 是否一定被执行,得靠实测验证,不能只看文档。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1611

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

3924

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1629

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

22577

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2767

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2807

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1123

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn