重写 __setattr__ 会触发 RecursionError,因其内部赋值(如 self.attr = value)再次调用自身;正确做法是统一使用 object.__setattr__(self, name, value) 绕过拦截并安全落值。

直接重写 __setattr__ 是最轻量、最通用的属性修改监控方式,但必须绕过它自身调用链,否则会无限递归崩溃。
为什么重写 __setattr__ 会报 RecursionError
当你在 __setattr__ 里直接写 self.attr = value 或 self.__dict__[key] = value,Python 会再次触发 __setattr__,形成死循环。这不是 bug,是设计使然——所有属性赋值都走这个入口。
常见错误现象:
RecursionError: maximum recursion depth exceeded- 类初始化失败,
__init__中给self.x = 1就崩
根本原因:没区分“初始化赋值”和“后续修改”,也没避开内置存储路径。
正确写法:用 object.__setattr__ 绕过拦截
必须用父类原始实现来存值,才能安全落库。这是唯一推荐的底层写法。
实操建议:
- 所有需要存入实例字典的操作,统一走
object.__setattr__(self, name, value) - 不要碰
self.__dict__直接赋值(除非你明确知道该字段不触发__setattr__) - 监控逻辑放在
object.__setattr__调用之前,避免漏掉任何一次赋值
示例:
class Config:
def __init__(self):
object.__setattr__(self, "_changed", set())
self.value = 0 # 这行也走 __setattr__,所以必须能扛住
<pre class="brush:php;toolbar:false;">def __setattr__(self, name, value):
print(f"属性 {name} 即将被设为 {value}")
# 记录变更
if name != "_changed":
object.__setattr__(self, "_changed", self._changed | {name})
# 安全落值
object.__setattr__(self, name, value)监控粒度:全局拦截 vs 局部字段控制
__setattr__ 是实例级钩子,无法按字段声明式控制;想只监控 port 和 timeout,就得手动判断 name。
使用场景差异:
- 做配置校验(如
if name == "timeout" and value ) - 记录审计日志(
print(f"{name} changed at {time.time()}")) - 触发外部同步(如硬件寄存器更新,见知识库中
TrackedValidatedInteger描述符方案)
性能影响很小,但要注意:每次 self.x = y 都进一次函数,高频写入场景下可测开销。
容易忽略的兼容性陷阱
__setattr__ 不处理类属性,只响应实例属性赋值。以下操作完全绕过它:
-
Config.default_port = 8080(类属性赋值) -
obj.__dict__["x"] = 1(跳过属性协议,直写字典) - 使用
setattr(obj, name, value)?——照样触发,没问题
真正难控的是 __slots__ 类:如果定义了 __slots__,未声明的属性赋值会直接抛 AttributeError,且 __setattr__ 仍会被调用——你得在报错前就检查合法性,否则用户看到的是双重错误。
复杂点在于:监控逻辑一旦混入业务判断(比如“只允许偶数”),就必须和初始化逻辑严格对齐,否则 __init__ 里设的初始值可能被误判为非法。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











