
当类显式定义了 __dict__ = ... 时,Python 实例的真实属性字典仍存在但被遮蔽;本文介绍两种可靠方法(类替换法与 ctypes 法)恢复访问,并分析其适用边界与风险。
当类显式定义了 `__dict__ = ...` 时,python 实例的真实属性字典仍存在但被遮蔽;本文介绍两种可靠方法(类替换法与 ctypes 法)恢复访问,并分析其适用边界与风险。
在 Python 中,__dict__ 是实例存储动态属性的核心字典。但若类中显式赋值 __dict__ = {...} 或将其设为不可变对象(如空字典、None),该赋值会覆盖描述符行为,导致 obj.__dict__ 不再返回底层属性字典,而返回被硬编码的值。值得注意的是:即使 __dict__ 被覆盖,实例仍能正常通过 obj.attr = value 设置属性——因为 CPython 在底层仍维护着真实的属性存储空间,只是 __dict__ 描述符被替换了。
✅ 推荐方案:类替换法(安全、纯 Python、兼容性强)
最稳健的方式是临时修改实例的 __class__,使其脱离原类对 __dict__ 的覆盖逻辑,从而触发默认的 object.__dict__ 描述符行为:
def get_true_dict(obj: object) -> dict:
original_cls = type(obj)
# 创建一个无任何自定义属性的空类(不继承原类,避免干扰)
temp_cls = type("TempClass", (), {})
# 使用 object.__dict__['__class__'].__set__ 绕过 __setattr__ 拦截
object.__dict__['__class__'].__set__(obj, temp_cls)
try:
return obj.__dict__ # 此时返回真实 dict
finally:
# 务必恢复原类,确保对象状态一致
obj.__class__ = original_cls
该方法优势显著:
- ✅ 绕过 __setattr__ 和 __class__ 自定义逻辑:直接调用 object 的底层描述符;
- ✅ 无需 C 扩展或内存操作,完全跨平台;
- ✅ 即使 __dict__、__class__、__setattr__ 全部被恶意重载,依然有效;
- ⚠️ 注意:修改 __class__ 是受支持的合法操作,但应仅用于调试/元编程场景,禁止在生产环境长期变更实例类型。
⚠️ 备选方案:ctypes 偏移法(高风险、不稳定)
另一种思路是直接读取 CPython 对象内存布局中的 __dict__ 字段偏移量:
import ctypes
def get_true_dict_by_offset(obj: object) -> dict:
# 获取 __dict__ 在 PyObject 中的偏移(仅适用于有 __dict__ 的类)
if not hasattr(type(obj), '__dictoffset__') or type(obj).__dictoffset__ == 0:
raise TypeError(f"{type(obj).__name__} has no instance __dict__")
# 计算真实 __dict__ 字段地址(依赖 CPython 内存布局)
obj_id = id(obj)
offset = type(obj).__dictoffset__
# 注意:此处需确保 __dict__ 已初始化(如首次访问过 obj.__dict__),否则可能为 NULL
dict_ptr = ctypes.cast(obj_id + offset, ctypes.POINTER(ctypes.py_object))
return dict_ptr.contents.value
⚠️ 严重限制:
- 仅适用于 CPython(非 PyPy / Jython);
- 若实例从未触发过 __dict__ 初始化(例如未访问 obj.__dict__ 或未设置任何属性),底层指针为空,将抛出 ValueError: PyObject is NULL;
- 内存布局可能随 Python 版本微调,不具备向后兼容性;
- 属于未公开实现细节,强烈不建议用于生产代码。
? 总结与最佳实践
| 方法 | 安全性 | 兼容性 | 稳定性 | 推荐场景 |
|---|---|---|---|---|
| 类替换法 | ✅ 高 | ✅ 所有解释器 | ✅ 强 | 调试、ORM 元编程、测试框架 |
| ctypes 偏移法 | ❌ 低 | ❌ CPython 专属 | ❌ 弱 | 仅限研究/极端场景探索 |
? 关键提醒:__dict__ 被覆盖本身通常是设计意图(如冻结实例、模拟不可变对象),强行绕过可能破坏封装契约。除非明确需要底层反射能力(如序列化框架、动态代理),否则应优先尊重类的设计语义。若需控制属性访问,请使用 __getattribute__、__slots__ 或 __dict__ 的只读封装,而非暴力覆盖。











