本文详解 Python 中静态方法被装饰器包装后，通过 self.method() 调用导致意外传入 self 的根本原因，并提供兼容 descriptor 协议的安全包装方案。

本文详解 python 中静态方法被装饰器包装后，通过 `self.method()` 调用导致意外传入 `self` 的根本原因，并提供兼容 descriptor 协议的安全包装方案。

在 Python 中，静态方法（@staticmethod）本质上是描述符（descriptor）对象，其核心行为由 __get__ 方法定义：当通过类访问（如 Test.static）时，返回原始函数；当通过实例访问（如 obj.static）时，仍返回原始函数（而非绑定方法），从而确保不自动注入 self。然而，一旦你用普通装饰器（如 wrap(Test.static)）直接替换类属性，就破坏了这一机制——因为 wrap() 返回的是普通函数，它不具备描述符行为。此时，Python 将该函数视为实例方法，在 self.static() 调用时自动将 self 作为第一个参数传入，引发 TypeError。

根本原因：描述符协议被绕过

# ❌ 错误做法：直接包装并赋值，丢失 staticmethod 描述符
Test.static = wrap(Test.static)  # wrap() 返回普通函数 → 无 __get__

此时 Test.static 已不是 staticmethod 实例，而是普通函数。当执行 self.static() 时，Python 按照「实例属性访问 → 绑定为实例方法」流程处理，等价于 Test.static.__get__(obj, Test)(...)，但普通函数没有 __get__，于是回退为隐式绑定，导致 self 被错误传入。

✅ 正确解法：保留描述符类型

必须确保包装后的对象仍具备原描述符的语义。关键在于：对 staticmethod 包装其 __func__，再用 staticmethod() 重新封装：

import functools
import inspect
import types

def wrap(f):
    @functools.wraps(f)
    def wrapped(*args, **kwargs):
        print(f"{f.__name__} called with args: {args}, kwargs: {kwargs}")
        return f(*args, **kwargs)
    return wrapped

def wrap_thing(thing):
    """安全包装任意类属性：函数、staticmethod、classmethod、property"""
    if isinstance(thing, types.FunctionType):
        return wrap(thing)
    elif isinstance(thing, staticmethod):
        return staticmethod(wrap(thing.__func__))  # ✅ 重建 staticmethod
    elif isinstance(thing, classmethod):
        return classmethod(wrap(thing.__func__))
    elif isinstance(thing, property):
        fget, fset, fdel = [
            None if attr is None else wrap(attr)
            for attr in [thing.fget, thing.fset, thing.fdel]
        ]
        return property(fget, fset, fdel, thing.__doc__)
    else:
        raise TypeError(f"Unsupported type: {type(thing)}")

# ✅ 正确包装：先获取原始描述符，再包装并重建
Test.static = wrap_thing(inspect.getattr_static(Test, 'static'))

? inspect.getattr_static(Test, 'static') 是关键：它绕过常规属性访问（避免触发 __get__），直接获取类字典中存储的原始 staticmethod 对象（而非调用其 __get__ 后的结果），从而保留 __func__ 引用。

验证效果

class Test:
    @staticmethod
    def static():
        print("hello")

    def method(self):
        self.static()  # ✅ 现在可安全调用

Test.static = wrap_thing(inspect.getattr_static(Test, 'static'))
Test().method()
# 输出：
# static called with args: (), kwargs: {}
# hello

注意事项与最佳实践

• 永远不要直接包装 @staticmethod 后赋值给类属性，除非显式重建 staticmethod()；
• 使用 inspect.getattr_static 获取原始描述符，避免因 __get__ 触发而拿到已解包的函数；
• 若需批量包装第三方库类的方法，建议封装为工具函数，统一处理 staticmethod/classmethod/property；
• functools.wraps 在 staticmethod(wrap(...)) 中依然有效，能正确继承原函数的 __name__、__doc__ 等元信息。

通过尊重 Python 的描述符协议，你既能实现日志、监控等横切关注点，又不会破坏原有调用约定——这才是健壮装饰器设计的核心原则。