__setattr__ 不能可靠捕获所有属性赋值,仅对点号赋值和 setattr() 生效;需用 self.__dict__[key] = value 避免递归,并在 __init__ 中标记初始化状态以区分首次赋值与后续修改。

__setattr__ 能否可靠捕获所有属性赋值
不能。直接操作实例字典(如 self.__dict__['x'] = 1)或调用父类 object.__setattr__ 会绕过它;__slots__ 类中未声明的属性赋值也会触发,但已声明的属性若通过 slot 直接写入,部分 Python 版本(如 3.12+)可能跳过 __setattr__ —— 这不是 bug,是设计使然。
真正能覆盖全部路径的方式是结合 __set_name__ + 描述符,但如果你只需要监控「显式点号赋值」(obj.attr = value)和常规初始化,__setattr__ 是最轻量且够用的选择。
- 只对
self.xxx = yyy和setattr(self, 'xxx', yyy)生效 - 不拦截
self.__dict__.update({...})或 C 扩展里直接写的字段 - 务必在日志逻辑后调用
super().__setattr__(name, value),否则属性根本不会被设置
如何避免 __setattr__ 递归崩溃
在 __setattr__ 里给任何属性赋值(包括 self._log、self._changed),都会再次触发 __setattr__,导致无限递归。常见错误是想存个时间戳或标记位,随手写 self._last_modified = time.time()。
唯一安全写法是直接操作实例字典:
立即学习“Python免费学习笔记(深入)”;
def __setattr__(self, name, value):
# 记录变更前先获取旧值(如果存在)
old_value = getattr(self, name, '<unset>')
# 直接写入 __dict__,绕过 __setattr__
self.__dict__['_log'].append({
'attr': name,
'old': old_value,
'new': value,
'at': time.time()
})
# 最后才真正设值 —— 仍需 super(),不能 self.__dict__[name] = value
super().__setattr__(name, value)
- 所有内部状态(如日志列表、开关标志)必须用
self.__dict__['xxx']写入 - 读取旧值用
getattr(self, name, default),别用self.__dict__.get(name)—— 缺失时可能漏掉 property 或描述符的动态计算值 - 如果类用了
__slots__,self.__dict__可能不存在,得改用object.__setattr__(self, '_log', ...)
区分初始化赋值和后续修改的实用技巧
构造函数里的赋值(__init__)通常不需要记日志,否则一建实例就刷一堆“从 None → xxx”,干扰真实业务变更。但 Python 没有内置标记位告诉你“这次是第一次设值”。
简单有效的做法是在 __init__ 结尾打个标记,然后在 __setattr__ 里检查:
def __init__(self):
self._log = []
self._initialized = False
self.value = 42
self.name = "test"
# 初始化完成后再开启监控
object.__setattr__(self, '_initialized', True)
<p>def <strong>setattr</strong>(self, name, value):
if not object.<strong>getattribute</strong>(self, '_initialized'):
super().<strong>setattr</strong>(name, value)
return</p><h1>此处开始记录日志...</h1><p>- 必须用
object.__getattribute__读_initialized,否则又进__setattr__ - 不要用
hasattr(self, '_initialized')—— 它内部会触发__getattr__,可能引发意外行为 - 如果类支持多次重置(如
reset()方法),记得在重置时重新关掉_initialized并清空日志
日志内容该存什么才真正有用
只记“谁变了”意义不大。线上出问题时,你更需要知道:这个值是从哪来的?被谁改的?改之前是不是刚被另一个模块设过?
建议至少包含四项:
-
attr:属性名(字符串) -
old和new:深拷贝后的值(尤其当值是 dict/list 时,避免后续被原地修改污染日志) -
caller:用inspect.stack()[1]拿到调用位置(文件、行号、函数名),比单纯打时间戳管用得多 -
source:标注是用户代码、框架回调,还是测试 mock(可加个上下文栈判断)
注意 copy.deepcopy 对某些对象(如 open file、threading.Lock)会失败,生产环境建议用 repr() 降级兜底,而不是让日志逻辑崩掉整个赋值流程。
监控本身不是目的,关键是在出问题时能快速还原现场——而还原的前提,是日志里存的信息刚好够你反向推理。


















