Python装饰器应用案例_权限与日志增强方法解析【技巧】

冷炫風刃
发布: 2025-12-20 11:25:22
原创
219人浏览过
装饰器是Python实现权限校验与日志记录等横切关注点的自然方式;支持参数化(如@require_role('admin'))、多角色校验、自动日志记录(含trace_id)、叠加使用及异步适配,需注意元信息保留、异常降级与三层嵌套结构。

python装饰器应用案例_权限与日志增强方法解析【技巧】

装饰器是 Python 中实现横切关注点(如权限校验、日志记录)最自然的方式。它不侵入业务逻辑,又能统一控制行为,特别适合权限与日志这类通用需求。

用装饰器做接口级权限控制

在 Web 开发中,常需对某些函数(如管理员操作)限制调用者身份。装饰器可集中处理鉴权逻辑,避免每个函数里重复写 if 判断。

  • 定义一个 @require_role('admin') 装饰器,接收角色名作为参数
  • 被装饰函数执行前,检查当前用户(比如从全局上下文或请求对象中取)是否具备该角色
  • 权限不足时抛出异常(如 PermissionError),由统一错误处理器响应 403
  • 支持多角色:@require_role('admin', 'editor') 表示满足其一即可

自动记录函数调用日志

对关键函数添加日志,能快速定位问题、追踪数据流向。装饰器可自动捕获函数名、参数、返回值和耗时,无需手动写 logging.info。

  • 使用 @log_calls(level='INFO'),自动记录入参、结果和执行时间(单位毫秒)
  • 异常时也记录堆,但不中断原逻辑(可选开关)
  • 支持按模块过滤:只对 user_service 模块下的函数生效,避免日志爆炸
  • 日志格式建议包含 trace_id(若已集成链路追踪),便于关联上下游调用

组合多个装饰器实现增强逻辑

权限与日志常需同时存在。Python 支持装饰器叠加,顺序影响执行流——越靠近函数的先运行(即“由外向内”进入,“由内向外”退出)。

标贝AI虚拟主播
标贝AI虚拟主播

一站式虚拟主播视频生产和编辑平台

标贝AI虚拟主播 69
查看详情 标贝AI虚拟主播

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

  • 写法示例:@log_calls @require_role('admin') def delete_user(user_id): ...
  • 执行时先走 log_calls 的进入逻辑 → 再走 require_role 校验 → 最后执行函数体
  • 返回时顺序相反:函数结果 → 权限装饰器后处理(通常无)→ 日志装饰器记录返回值与耗时
  • 注意:若权限校验失败抛异常,log_calls 仍能捕获并记录异常,前提是它的 try/except 包含了整个 wrapped 函数调用

实际使用中的关键细节

装饰器看似简单,但几个细节没处理好容易踩坑。

  • 保留原函数元信息:用 @functools.wraps(func) 包装内层函数,否则 docstring、__name__ 会变成装饰器内部函数名
  • 支持带参数的装饰器:需嵌套三层函数(最外层接收装饰器参数,中间接收被装饰函数,最内层是实际 wrapper)
  • 避免装饰器自身出错影响业务:日志或权限模块异常时,应降级处理(如跳过日志、允许访问),而非让整个接口崩掉
  • 异步函数要单独适配:普通装饰器无法直接用于 async def 函数,需用 async def wrapper 并 await 调用原协程

以上就是Python装饰器应用案例_权限与日志增强方法解析【技巧】的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号