登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  python教程

Python inspect.getattr_static 怎样取得描述符本身而不执行属性访问

来源:17golang原创

时间:2026-11-18 16:50:35 273浏览 收藏

平时写Python代码碰到类属性是描述符的场景,直接调用内置的getattr拿属性,会自动触发描述符的__get__方法执行里面的访问逻辑,根本取不到描述符本身。用标准库inspect模块提供的getattr_static方法,就能绕过常规属性访问流程,直接从类和实例的命名空间中拿到描述符原对象,不会触发对应的属性访问逻辑。

它不会触发描述符的绑定调用,也不会走实例的__getattribute__常规处理流程,最终返回你要找的原始属性对象。

做对象审计、插件扫描或文档生成时,我经常只想知道“这个名字在类上到底放了什么”,却不想为了读取它而执行 property、触发 __getattribute__,甚至让 __getattr__ 临时创建一个值。这个场景用 inspect.getattr_static() 更合适:它返回属性槽位里的原始对象,不走动态属性查找。

官方文档:https://docs.python.org/3/library/inspect.html

要点速览
  • getattr_static(obj, name, default) 适合读取原始属性对象,核心目标是避免 descriptor 和动态查找。
  • 返回值可能是普通值,也可能是 property 等 descriptor;它不是“已经执行后的属性值”。
  • 动态创建的成员可能看不到;如果业务真正需要运行时值,仍应明确调用普通属性访问并承担副作用。

getattr_static 读取的到底是什么

getattr(obj, name) 的结果是一次运行时访问,可能经过 descriptor 协议、__getattribute__ 和 __getattr__。而 inspect.getattr_static 的关注点是“名称对应的原始成员”,所以读取 property 时拿到的是 property 对象本身,而不是 getter 的返回值。

import inspect

class Account:
    # 这个属性读取时会执行函数;静态读取只拿到 property 对象
    @property
    def balance(self):
        return 99

    # 动态访问找不到 missing 时才会进入这里
    def __getattr__(self, name):
        return f"generated:{name}"

account = Account()
raw = inspect.getattr_static(account, "balance")
print(type(raw).__name__)       # property
print(getattr(account, "balance"))  # 99
print(inspect.getattr_static(account, "missing", None))  # None

这里的两个结果不能混为一谈:raw 描述“类上定义了什么”,普通 getattr 描述“这次访问产生了什么”。做静态审计时,先保存 raw,不要为了打印它再调用其 getter。

Python inspect.getattr_static 与动态属性访问在 descriptor、__getattribute__ 和 __getattr__ 边界上的结构说明图
图1:结构说明图,比较动态属性访问与 getattr_static 的边界。

参数与查找边界怎么把握

第一个参数是对象,第二个参数是属性名,第三个参数是可选的缺省值。建议在扫描工具中显式传入一个哨兵对象,这样“属性不存在”和“属性值刚好是 None”不会混淆。

情况静态读取结果处理建议
实例字典中的普通值返回原始值可记录类型与来源
类上的 property返回 property descriptor先判断 descriptor,再决定是否执行
继承得到的成员可能从父类找到记录定义类,别误判为实例字段
只由 __getattr__ 动态生成通常返回缺省值需要运行时值时再走明确回退
import inspect

MISSING = object()
raw = inspect.getattr_static(account, "balance", MISSING)

if raw is MISSING:
    # 缺少静态成员,不代表动态访问一定失败
    print("没有找到静态属性槽位")
elif inspect.isdatadescriptor(raw):
    # property 等对象应先作为 descriptor 记录,避免意外执行
    print("descriptor:", type(raw).__name__)
else:
    # 普通值可以安全地进入元数据记录流程
    print("value type:", type(raw).__name__)

需要注意,静态查找不是万能的“安全 getattr”。官方文档明确提示,它可能看不到动态创建的成员,也可能找到普通访问拿不到的 descriptor。这个差异正是它适合做结构检查的原因。

根据返回对象判断下一步

如果返回 property、方法 descriptor 或其他带 __get__ 的对象,先把它当成描述信息保存;不要直接假设它是业务值。可以使用 inspect.isdatadescriptor() 做一个粗分类,但最终仍要结合项目自己的 descriptor 类型判断。

对实例字段、类字段和 __slots__ 的审计,建议同时记录“对象类型、属性名、返回对象类型、是否来自继承链”。这样日志能回答“类上声明了什么”,而不是只留下一个难以解释的字符串。

Python inspect.getattr_static 返回普通值、property、继承成员和缺省哨兵的关系说明图
图2:关系说明图,按返回对象类型决定读取、记录或回退策略。

排查清单:什么时候不要用它

  • 要验证 getter 的业务结果时,不要把静态对象当成最终值。
  • 要发现运行时注入属性时,静态查找可能漏报,需要补充明确的动态路径。
  • 要处理不可信对象时,即便静态读取减少了执行机会,也要限制对象来源和后续反射操作。
  • 要区分缺失与 None 时,使用独立哨兵,不要把 None 直接当默认值。

相关问题

getattr_static 会执行 property 的 getter 吗?

不会。它返回 property descriptor 本身;只有后续明确进行普通属性访问或调用 descriptor,才会进入 getter。

为什么静态读取找不到 __getattr__ 生成的字段?

因为这个字段没有稳定地存放在实例或类的属性槽位中,而是访问失败后动态产生。静态读取关注已存在的成员,不负责模拟这段逻辑。

什么时候应该改用 getattr?

当目标是业务运行时值,并且你已经接受 getter 或自定义访问逻辑的副作用时,再使用 getattr;最好把这一步和静态审计分开。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>