Python类属性修改监控与日志记录

Python中通过重写`__setattr__`实现属性修改监控虽轻量实用，但存在诸多陷阱：它无法捕获`self.__dict__`直接赋值、`object.__setattr__`调用或`__slots__`类中部分原生属性写入等绕过路径；若不谨慎处理，极易因递归调用导致崩溃——所有内部状态（如日志列表、初始化标记）必须绕过`__setattr__`直操作`__dict__`或用`object.__setattr__`，且读取旧值须用`getattr`而非`__dict__.get`以兼容动态属性；更关键的是，需在`__init__`末尾显式标记初始化完成，并在`__setattr__`中用`object.__getattribute__`安全检测，才能精准区分初始化赋值与真实业务变更；而真正有价值的日志不止记录“变了什么”，更要存属性名、深拷贝（或安全降级的）新旧值、精确调用栈（文件/行号/函数）及上下文来源——因为监控的终极目标不是记录，而是在线上故障时，让你仅凭日志就能完整还原变更链路与现场。

__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()。

唯一安全写法是直接操作实例字典：

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)
</unset>

• 所有内部状态（如日志列表、开关标志）必须用 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></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() 降级兜底，而不是让日志逻辑崩掉整个赋值流程。

监控本身不是目的，关键是在出问题时能快速还原现场——而还原的前提，是日志里存的信息刚好够你反向推理。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python类属性修改监控与日志记录》文章吧，也可关注golang学习网公众号了解相关技术文章。