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

装饰器是Python实现权限校验与日志记录等横切关注点的自然方式；支持参数化（如@require_role('admin')）、多角色校验、自动日志记录（含trace_id）、叠加使用及异步适配，需注意元信息保留、异常降级与三层嵌套结构。

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

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

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

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

自动记录函数调用日志

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

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

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

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

标签： python 处理器 app 栈 ai