性能审计装饰器必须用time.perf_counter()而非time.time()，因其单调递增、高精度且不受系统时钟调整影响；校验装饰器需结合inspect.signature()和typing模块解析类型注解，运行时校验参数；组合使用时校验须在外层以确保性能数据准确。
性能审计装饰器必须用 time.perf_counter()，不是 time.time()
用 time.time() 做函数计时在高并发或系统时间跳变时会出错——它受系统时钟调整影响，可能返回负耗时或突增抖动。而 time.perf_counter() 是单调递增的高精度计时器，专为性能测量设计。
实操建议：
- 始终用
time.perf_counter()获取起止时间，差值即真实执行耗时 - 避免在
wrapper中做任何非必要操作（如格式化字符串、日志 I/O），否则污染测量结果 - 若需记录多次调用统计，别在装饰器闭包里用全局
list累积——线程不安全；改用threading.local()或外部指标收集器
示例片段：
import time
from functools import wraps
<p>def audit_performance(func):
@wraps(func)
def wrapper(*args, *<em>kwargs):
start = time.perf_counter()
result = func(</em>args, **kwargs)
elapsed = time.perf_counter() - start
print(f"[AUDIT] {func.<strong>name</strong>}: {elapsed:.6f}s")
return result
return wrapper
</p>
输入参数校验装饰器要区分“类型注解”和“运行时断言”
Python 的类型提示（def f(x: int) -> str:）本身不触发校验，只是元数据。真正在运行时拦截非法输入，得靠装饰器手动检查 args 和 kwargs，再结合 inspect.signature() 提取标注信息。
常见错误现象：
- 直接用
isinstance(arg, expected_type)但忽略Union、Optional或泛型（如List[str]），导致校验失败 - 对
**kwargs不做键名匹配，只校验值类型，漏掉字段缺失或多余字段问题 - 把校验逻辑写死在装饰器里，无法适配不同函数的参数结构
推荐做法：
- 用
typing.get_origin()和typing.get_args()解析复杂类型 - 校验失败时抛
TypeError（不是ValueError），语义更准确 - 允许通过参数开关禁用校验（如
@validate_params(enabled=DEBUG)），方便压测绕过
组合使用时注意装饰器顺序：校验必须在性能审计外层
如果同时加 @audit_performance 和 @validate_params，顺序错了会导致性能数据失真——比如校验失败抛异常，但审计装饰器仍会把异常处理时间计入“函数执行耗时”。
正确顺序是：
@validate_params
@audit_performance
def risky_func(x: int, y: str):
...
原因：
-
@validate_params在最外层，先拦截非法输入并提前退出，不进入audit_performance的计时范围 - 若反过来，
audit_performance会从进入 wrapper 就开始计时，哪怕后续立刻 raise TypeError，耗时也被记录 - 这种顺序也符合逻辑流：先确认输入合法，再测“合法输入下的真实性能”
带参数的复合装饰器别硬套三层嵌套，用 functools.partial 更清晰
想让一个装饰器同时支持“开/关性能审计”和“指定校验严格等级”，不必强行写五层函数嵌套。容易漏掉 @wraps、混淆作用域、调试困难。
更稳妥的做法是拆成两个独立装饰器，用 functools.partial 预置参数：
from functools import partial <h1>预置参数的校验装饰器</h1><p>strict_validator = partial(validate_params, level="strict") loose_validator = partial(validate_params, level="warn")</p><h1>组合使用</h1><p>@strict_validator @audit_performance def process_user(user_id: int): ... </p>
这样既保持单职责，又避免嵌套过深带来的可读性下降。真正需要“参数+函数+逻辑”三合一的场景（如限流、缓存键生成），再上标准三层结构。
最易被忽略的一点：所有装饰器内部的 print 或日志输出，如果没加锁或没走异步队列，在多线程下调用高频函数时会成为性能瓶颈本身——审计和校验逻辑不能比被测函数还慢。
