本文介绍一种基于注册表（registry）模式的可靠方案，解决方法装饰器标签被外层装饰器遮蔽的问题，无需约束装饰器顺序或要求第三方装饰器适配。
本文介绍一种基于注册表（registry）模式的可靠方案，解决方法装饰器标签被外层装饰器遮蔽的问题，无需约束装饰器顺序或要求第三方装饰器适配。
在 Python 中，使用装饰器为方法“打标签”（如标记为需特殊处理的视图方法、事件处理器等）是一种常见模式。传统做法是直接在函数对象上设置属性（如 func.use_class = True），再由类装饰器遍历 cls.__dict__ 查找这些标记。但该方式存在根本性缺陷：一旦方法被非透明装饰器（例如日志、缓存、权限校验等封装了原函数的装饰器）包裹，原始函数对象即被替换，其上的自定义属性将不可见，导致标签丢失。
例如以下代码会失败：
def hiding_decorator(fn):
def wrapper(*args, **kwargs):
print("do some logging etc.")
return fn(*args, **kwargs)
return wrapper
@class_decorator # 依赖 func.use_class 属性
class ModelA:
@hiding_decorator
@method_decorator # 设置 use_class=True
def a_method(self): ...
此时 a_method 在 ModelA.__dict__ 中已是 wrapper 对象，不再携带 use_class 属性。
✅ 推荐方案：注册表（Registry）模式
核心思想是分离“声明”与“绑定”：
- 方法装饰器不修改函数本身，而是将方法名登记到一个全局/类级注册表中；
- 类装饰器在类创建完成后，通过
getattr(cls, name)动态获取最终绑定到类上的方法对象（即经过所有装饰器处理后的结果），确保操作的是运行时真实可用的方法。
以下是完整、可复用的实现：
class Registry:
def __init__(self):
self._method_names = []
def register(self, func):
"""方法装饰器：仅记录方法名，不修改 func"""
self._method_names.append(func.__name__)
return func
def apply(self, cls):
"""类装饰器：遍历已注册名称，安全获取装饰后的方法"""
for name in self._method_names:
if hasattr(cls, name):
method = getattr(cls, name)
print(f"Processing {cls.__name__}.{name} → {method}")
# ✅ 此处 method 是最终生效的、带所有装饰逻辑的可调用对象
self._process_method(cls, name, method)
return cls
def _process_method(self, cls, name, method):
# 示例：注册到某框架路由、事件总线或元数据容器
pass
# 使用示例
registry = Registry()
@registry.apply
class ModelA:
@hiding_decorator
@registry.register # ✅ 位置灵活：可内层、可外层，不影响注册
def a_method(self):
return "processed"
@registry.register
@hiding_decorator # 同样有效
def b_method(self):
return "also processed"
? 输出中
method是wrapper函数（即hiding_decorator返回的对象），这正是我们希望处理的真实运行时方法——它已集成日志、权限等全部逻辑，无需绕过装饰器链。
⚠️ 注意事项与最佳实践
-
注册表实例应唯一且作用域明确：建议每个用途（如
view_registry,signal_registry）使用独立的Registry()实例，避免命名冲突； -
注册时机安全：
@registry.register在函数定义时执行（早于类装饰器），因此self._method_names在@registry.apply运行前已就绪； -
兼容性极强：不依赖
__wrapped__或functools.wraps，对任何装饰器（包括未正确设置__wrapped__的第三方装饰器）均健壮； -
可扩展性强：可在
register()中接收额外参数（如@registry.register(priority=10, group="api")），构建更丰富的元数据系统； -
避免误注册：若需支持继承，应在
apply()中检查getattr(cls, name, None) is not getattr(super_cls, name, None)，防止重复处理父类方法。
该方案彻底规避了“属性丢失”问题，同时保持接口简洁、语义清晰，是构建可组合、可维护装饰器生态的推荐范式。
