重试装饰器需捕获特定异常、支持动态参数配置、区分同步/异步、透传参数并记录日志，且不能替代资源管理。
重试装饰器必须捕获特定异常，不能用 Exception 一锅端
直接 except Exception: 会导致网络超时、数据库连接中断等可重试错误，和拼写错误、类型错误等不可重试错误混为一谈。重试逻辑只对临时性故障有意义。
实操建议：
- 明确列出需重试的异常类，例如
requests.exceptions.ConnectionError、TimeoutError、sqlite3.OperationalError - 避免捕获
KeyboardInterrupt和SystemExit，否则 Ctrl+C 会失效 - 若不确定异常类型，先加日志打印
type(e).__name__，再决定是否纳入重试范围
@retry(max_attempts=3, delay=1) 这类参数必须支持动态传入，不能硬编码
不同接口/任务的容错策略差异很大：调用第三方 API 可能要 5 次重试 + 指数退避，而本地文件读取失败通常 2 次就够了。硬编码会让装饰器失去复用价值。
实操建议：
- 装饰器本身返回闭包函数，支持
@retry(max_attempts=5, delay=2)调用方式 -
delay建议默认为 0（立即重试），避免无意义等待；如需退避，用delay * (2 ** attempt)实现简单指数增长 - 加入
backoff布尔开关，方便关闭退避逻辑做调试
重试过程中必须记录日志，且区分「第几次尝试」和「最终失败原因」
没有日志的重试等于黑盒：你不知道是第一次就成功了，还是第五次才勉强通过，更不知道最后一次失败到底抛了什么异常。
实操建议：
- 每次重试前打一条
INFO日志，包含函数名、当前尝试次数（attempt=1/3） - 最终失败时，用
logging.error(..., exc_info=True)输出完整 traceback - 避免在装饰器里用
print()—— 生产环境日志系统收不到，也难过滤
带参数的函数和异步函数要用不同装饰器，混用会静默失效
给 async def 函数套同步重试装饰器，或给带 *args, **kwargs 的函数用没处理参数透传的装饰器，都会导致运行时行为异常：可能根本不重试、参数丢失、甚至报 RuntimeWarning: coroutine 'xxx' was never awaited。
实操建议：
- 同步函数用标准
functools.wraps+for循环重试 - 异步函数必须用
async def定义的装饰器，内部用await调用原函数 - 所有装饰器都显式支持
*args, **kwargs，并原样透传，不要漏掉**kwargs
真正麻烦的是状态残留：比如函数里打开了文件但没关，重试时可能因文件被占用而失败。装饰器解决不了资源管理问题，该用 try/finally 或上下文管理器的地方，一个都不能少。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
