装饰器还能这么玩？手把手教你写出能“重试”的异步函数
1. 什么是装饰器
要理解装饰器，我们得先看透它的本质。在Python世界里，装饰器就是个“高阶函数”——它可以把一个函数作为“原料”吃进去，加工后再吐出一个功能增强的新函数。整个过程，原始函数代码纹丝不动。
免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈
简单来说，它就是个能装进“通用功能”的工具箱。这个工具箱能发挥作用，全赖Python语言的三项核心能力：
- 函数是一等公民：函数和其他数据类型（比如字符串、列表）平起平坐，可以被当成参数传递，也可以作为结果返回。这是装饰器得以实现的理论基石。
- 闭包特性：装饰器通常依靠闭包来“记住”外部作用域的变量和参数。这就像给工具箱上了锁，把原始函数的状态牢牢锁在里面，无论搬到哪里用都不会丢失。
- 语法糖支持：Python用那个简洁的
@符号，把原本有点绕的调用过程变得无比优雅。没有它，装饰器虽能用，但代码的观感会大打折扣。
2. 装饰器的核心作用
装饰器这么受欢迎，到底能带来什么实在的好处？归根结底，是下面四条：
- 代码复用：谁也不想在不同的函数里重复写着同样的日志、计时代码吧？把这些“通用套路”抽象成一个装饰器，一次写好，随处复用。
- 逻辑解耦：想象一下，业务逻辑是主菜，而日志、权限、监控就像是调料。装饰器帮我们把“炒菜”和“调味”分离开，代码结构瞬间清晰，各司其职。
- 动态扩展：这恰好符合软件设计的“开闭原则”——对扩展开放，对修改关闭。给函数增加新能力，不必动它的源代码，运行时动态“戴上”装饰器就行。
- 非侵入性：这是最大的魅力所在。无论需要什么新功能，都无需入侵原有函数内部。原来的接口什么样，现在还是什么样，对调用者完全透明。
3. 装饰器的常见应用场景
明白了道理，就得看实战。下面这几个场景，几乎每个Python开发者都会遇到。我们可以把它想象成给游戏角色加“Buff”，让代码能力瞬间提升。
(1) 日志记录
自动记录函数何时被调用、何时结束，就像游戏里的“成就系统”，忠实地记录下每一次关键操作。
import functools
import datetime
def logger(func):
@functools.wraps(func)
def wrapper(*args, **kwargs):
print(f"[{datetime.datetime.now()}] 调用函数: {func.__name__}")
result = func(*args, **kwargs)
print(f"[{datetime.datetime.now()}] 函数 {func.__name__} 执行完成")
return result
return wrapper
@logger
def process_data():
print(“正在处理数据…”)(2) 性能计时
测量函数执行时间，好比“速度跑酷”的计时器，精准告诉你每个环节花了多少秒。性能优化的第一步，往往就从这里开始。
import time
import functools
def timer(func):
@functools.wraps(func)
def wrapper(*args, **kwargs):
start = time.time()
result = func(*args, **kwargs)
end = time.time()
print(f”函数 {func.__name__} 执行耗时: {end-start:.4f}秒")
return result
return wrapper(3) 权限验证
控制哪些用户能访问特定函数，这功能就像游戏里的“区域权限”。普通玩家进不了管理员地图，在代码层面也是同样的逻辑。
def permission_check(required_role):
def decorator(func):
def wrapper(*args, **kwargs):
user_role = getattr(args[0], ‘role’, ‘guest’) if args else ‘guest’
if user_role != required_role:
raise PermissionError(f"需要 {required_role} 权限")
return func(*args, **kwargs)
return wrapper
return decorator
class Admin:
def __init__(self):
self.role = ‘admin’
@permission_check(‘admin’)
def delete_user(self):
print(“删除用户操作成功”)(4) 缓存机制
对于计算成本高昂或频繁读取相同数据的函数，加个缓存装饰器，能立竿见影地提升性能，避免无谓的重复劳动。
def cache(func):
stored = {}
@functools.wraps(func)
def wrapper(*args):
if args in stored:
print(“从缓存获取结果”)
return stored[args]
result = func(*args)
stored[args] = result
return result
return wrapper
@cache
def fibonacci(n):
if n < 2:
return n
return fibonacci(n-1) + fibonacci(n-2)4. 装饰器的异步实现方法
进入异步编程的世界，装饰器的写法也需要“升级换代”。核心区别在于，异步装饰器的包装函数必须用async def来定义，并且在调用被装饰的异步函数时，必须加上await。这一步要是忘了，程序要么报错，要么就失去了异步的能力。
(1) 异步计时器
给异步函数计时的逻辑和同步版类似，但获取时间和等待都得用异步的方式。
import asyncio
import functools
import datetime
def async_timer(func):
@functools.wraps(func)
async def wrapper(*args, **kwargs):
start = asyncio.get_event_loop().time()
print(f"[{datetime.datetime.now()}] 异步函数 {func.__name__} 开始执行")
result = await func(*args, **kwargs)
end = asyncio.get_event_loop().time()
print(f"[{datetime.datetime.now()}] 异步函数 {func.__name__} 执行完成，耗时: {end-start:.4f}秒")
return result
return wrapper
@async_timer
async def fetch_data():
print(“正在获取数据…”)
await asyncio.sleep(2) # 模拟异步IO操作
print(“数据获取完成”)
# 运行异步函数
asyncio.run(fetch_data())(2) 异步重试机制
网络请求不稳定是常态。一个健壮的异步重试装饰器，能让你的程序在面对临时故障时更加从容。
import asyncio
import functools
import random
def async_retry(max_attempts=3, delay=1):
def decorator(func):
@functools.wraps(func)
async def wrapper(*args, **kwargs):
for attempt in range(max_attempts):
try:
return await func(*args, **kwargs)
except Exception as e:
if attempt == max_attempts - 1:
raise e
print(f”第{attempt+1}次尝试失败: {e}，{delay}秒后重试…”)
await asyncio.sleep(delay)
return wrapper
return decorator
@async_retry(max_attempts=3, delay=1)
async def unreliable_api():
# 模拟不稳定的API调用
if random.random() < 0.7: # 70%概率失败
raise ConnectionError(“网络连接失败”)
print(“API调用成功”)
# 运行异步函数
asyncio.run(unreliable_api())(3) 异步缓存
异步函数的缓存逻辑同样关键。需要注意的是，缓存字典的访问在异步环境下也需要注意线程安全（本例为简单演示，在复杂并发场景下可能需要引入锁机制）。
import asyncio
import functools
def async_cache(func):
stored = {}
@functools.wraps(func)
async def wrapper(*args):
if args in stored:
print(“从缓存获取异步结果”)
return stored[args]
result = await func(*args)
stored[args] = result
return result
return wrapper
@async_cache
async def get_user_info(user_id):
print(f”正在获取用户{user_id}信息…”)
await asyncio.sleep(1) # 模拟异步IO
return {“id”: user_id, “name”: f"用户{user_id}"}
# 运行异步函数
async def main():
# 第一次调用，会执行函数
user1 = await get_user_info(1)
print(user1)
# 第二次调用，会从缓存获取
user2 = await get_user_info(1)
print(user2)
asyncio.run(main())5. 高级用法
掌握了基础，再来看看那些能让装饰器更强大、更灵活的“进阶技巧”。
(1) 带参数的装饰器
有时候，我们想动态配置装饰器的行为，比如重试次数、延迟时间。这就需要让装饰器本身也能接收参数，其结构会多嵌套一层。
def retry(max_attempts=3, delay=1):
def decorator(func):
@functools.wraps(func)
def wrapper(*args, **kwargs):
for attempt in range(max_attempts):
try:
return func(*args, **kwargs)
except Exception as e:
if attempt == max_attempts - 1:
raise e
print(f”第{attempt+1}次尝试失败，{delay}秒后重试…”)
time.sleep(delay)
return wrapper
return decorator(2) 类装饰器
除了用函数实现，装饰器还可以是一个类。通过实现__call__方法，类的实例就能像函数一样被调用，同时还能利用类的属性来保存更复杂的状态。
class CountCalls:
def __init__(self, func):
self.func = func
self.count = 0
def __call__(self, *args, **kwargs):
self.count += 1
print(f”函数 {self.func.__name__} 被调用 {self.count} 次")
return self.func(*args, **kwargs)6. 小结
回头看文章开头的那个电商平台深夜故障。如果那位工程师提前为关键的process_order函数装配了具备详细链路追踪和性能计时的异步装饰器，那么问题排查很可能就是几分钟的事：日志会清晰指出卡在支付、库存还是物流环节，耗时数据会直接定位到性能瓶颈。
这就是装饰器的力量。它通过一种非侵入式的优雅方式，将那些横跨多个模块的共性需求——日志、监控、安全、缓存——封装起来。从同步到异步，从基础功能到动态参数，装饰器提供了一套强大的元编程工具。掌握它，意味着你掌握了为代码批量、动态赋能的能力。下次当你发现自己在不同函数中复制粘贴同一段代码时，就该考虑是不是该把它抽象成一个装饰器了。
热门专题
热门推荐
Lemonaid是什么 如果你正为音乐创作寻找得力助手，那么Lemonaid很可能就是答案。它是一款专门面向专业音乐人打造的AI音乐生成工具，核心能力在于自主生成包含完整旋律、和声与节奏的乐曲。无论是想要一段氛围感十足的背景音乐，还是为具体场景定制配乐，它都能提供高度逼真且质量上乘的作品。工具提供了
苹果也要出折叠屏，传闻已经有几年了，从目前供应链、分析师与知名爆料者释放的信息来看，这款与市面大折都不一样的阔折叠似乎已经蓄势待发，大概率今年下半年就要正式面市。今天我们就来为大家汇总一波，没准儿就有你想知道的消息。 关于苹果折叠屏手机的传闻，已经流传了好几年。如今，综合供应链、分析师以及各路知名爆
《刺客信条：黑旗重制版》官宣之际，这款新海盗游戏为何能抢先赢得玩家口碑？ 当游戏界的焦点都集中在《刺客信条：黑旗重制版》的正式公布时，一款名为《风启之旅》（Windrose）的开放世界海盗生存建造游戏，却凭借其过硬的品质与独特的玩法融合，悄然在玩家社区中掀起热议。这款由乌兹别克斯坦团队Kraken
产品介绍 提到云端智能视频创作，腾讯智影是一个绕不开的名字。这款由腾讯推出的平台，本质上是一个一站式的在线视频工厂，集成了从素材挖掘、剪辑、渲染到最终发布的全链路功能，旨在为用户提供全方位的视频创作解决方案。更吸引人的是，它不仅免费开放，还深度整合了多项前沿AI技术，目标很明确：让视频化表达这件事，
《王者荣耀世界》线下活动风波：合影互动引争议，职业素养与网络舆论深度探讨 近日，《王者荣耀世界》的一场线下玩家见面会，因台上一次短暂的合影互动，意外成为全网热议的焦点。活动中，一位男粉丝上台与角色扮演者（Coser）合影时，主动做出比心手势以示友好，却未得到身旁Coser的任何回应。男生举着手势在原