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。

参数与查找边界怎么把握
第一个参数是对象,第二个参数是属性名,第三个参数是可选的缺省值。建议在扫描工具中显式传入一个哨兵对象,这样“属性不存在”和“属性值刚好是 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__ 的审计,建议同时记录“对象类型、属性名、返回对象类型、是否来自继承链”。这样日志能回答“类上声明了什么”,而不是只留下一个难以解释的字符串。

排查清单:什么时候不要用它
- 要验证 getter 的业务结果时,不要把静态对象当成最终值。
- 要发现运行时注入属性时,静态查找可能漏报,需要补充明确的动态路径。
- 要处理不可信对象时,即便静态读取减少了执行机会,也要限制对象来源和后续反射操作。
- 要区分缺失与
None时,使用独立哨兵,不要把None直接当默认值。
相关问题
getattr_static 会执行 property 的 getter 吗?
不会。它返回 property descriptor 本身;只有后续明确进行普通属性访问或调用 descriptor,才会进入 getter。
为什么静态读取找不到 __getattr__ 生成的字段?
因为这个字段没有稳定地存放在实例或类的属性槽位中,而是访问失败后动态产生。静态读取关注已存在的成员,不负责模拟这段逻辑。
什么时候应该改用 getattr?
当目标是业务运行时值,并且你已经接受 getter 或自定义访问逻辑的副作用时,再使用 getattr;最好把这一步和静态审计分开。
-
227 收藏
-
290 收藏
-
129 收藏
-
198 收藏
-
470 收藏
-
文章 · python教程 | 4小时前 | 标准库 · Python教程 · Python decimal flags 精度 舍入 Context.copy_abs Decimal.copy_abs389 收藏
-
文章 · python教程 | 4小时前 | 字符串 · 标准库 · Python教程 · Python placeholder 文本截断 textwrap TextWrapper max_lines301 收藏
-
411 收藏
-
文章 · python教程 | 7小时前 | 反射 · 调试 · python · Python inspect.getmembers_static inspect.getmembers descriptor __getattr__358 收藏
-
287 收藏
-
341 收藏
-
文章 · python教程 | 11小时前 | 错误处理 · 字符集 · Python教程 · Python MIME email.utils collapse_rfc2231_value RFC 2231330 收藏
-
479 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习