当前位置:首页 > 文章列表 > 文章 > python教程 > Python inspect.getattr_static 怎样取得描述符本身而不执行属性访问

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

来源:17golang原创 2026-11-18 16:50:35 0浏览 收藏

平时写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删除
Go image.Rectangle.Union 怎样求两个矩形的最小包围区间Go image.Rectangle.Union 怎样求两个矩形的最小包围区间
上一篇
Go image.Rectangle.Union 怎样求两个矩形的最小包围区间
Go go/types.NewMap 怎样组合键类型和值类型生成 map 类型
下一篇
Go go/types.NewMap 怎样组合键类型和值类型生成 map 类型
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1258次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1198次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1047次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码