Python限制方法仅实例调用对super()的影响及描述符继承问题

需求背景 #

需要实现实例方法调用限制：仅允许通过类的实例对象调用方法，禁止直接通过类调用方法，避免开发者误写Foo.bar(42)引发难以定位的非预期错误，同时需确认实现不会破坏Python数据模型原有逻辑（比如影响super()调用）。

Python默认支持两种实例方法调用形式，示例如下：

class Foo:
    def bar(self, x=None):
         print(x)

Foo().bar(42)  # 合法：实例调用，正常输出42
Foo.bar(Foo(), 42)  # 默认允许：类直接调用，手动传实例，输出42

其中第二种类直接调用的形式容易被误写为Foo.bar(42)，此时参数x取默认值None，错误打印None，且这类错误会随方法重构变化，排查成本高。

初始实现与异常现象 #

参考Python描述符协议实现的装饰器初始版本如下：

from types import MethodType

class OnlyMethodNotUnboundFunction:
    def __init__(self, func):
        self.func = func
    def __get__(self, obj, objtype=None):
        if obj is None:
            raise UnboundLocalError("This method can only be used by an instantiated object, not a Class")
        return MethodType(self.func, obj)

class Foo():
    @OnlyMethodNotUnboundFunction
    def bar(self, x=None):
        print(x)

该版本下Foo().bar(42)可正常运行，Foo.bar(42)会按预期抛出错误，但子类通过super()调用父类方法时未触发拦截，测试子类代码如下：

class Baz1(Foo):
    def bar(self, x=None):
        super().bar(x)
        print(x + 1)

class Baz2(Foo):
    def bar(self, x=None):
        super(Baz2, self).bar(x)
        print(x + 1)

实际测试时，Baz1.bar(Baz1(), 42)和Baz2.bar(Baz2(), 42)均可正常运行，依次打印42、43，和「无参super会返回父类、触发类调用报错」的预期不符。

问题解答 #

1. super()调用未触发拦截的底层原理 #

super()不会返回裸的父类对象，返回的是一个绑定了特定MRO查找起点与上下文的super代理对象，其属性访问逻辑完全符合Python描述符协议，不会触发obj is None的拦截分支：

• 无参super()是Python编译器提供的语法糖，会在方法执行上下文里自动填充当前定义的类、方法的第一个位置参数（即self），等价于显式写法super(当前子类, self)，不存在「无参super返回未绑定实例的父类」的情况。
• 当super代理绑定的第二个参数是实例时，代理在按MRO查找父类属性（比如父类上的方法描述符）后，会自动将绑定的实例作为obj参数传入描述符的__get__方法，此时obj是真实的子类实例，不是None，因此描述符会正常返回绑定实例的方法，不会触发报错。
• 只有当super绑定的第二个参数是类本身（比如写super(Baz2, Baz2).bar(42)）时，代理才会传obj=None给描述符，此时才会触发拦截逻辑，这属于符合预期的正常行为。

该现象完全符合Python数据模型规范，说明当前描述符没有破坏super的原生逻辑。

2. 完善实现：支持子类继承拦截，不影响正常super调用 #

初始实现存在两个可优化点：一是抛出的UnboundLocalError是Python内置的作用域错误，语义不匹配，容易和真实的变量未绑定错误混淆；二是子类重写方法时如果忘记加装饰器，会绕过拦截逻辑。完善后的实现如下：

from types import MethodType

# 自定义语义匹配的异常，避免和内置异常混淆
class InstanceMethodOnlyError(TypeError):
    """实例方法禁止通过类直接调用时抛出"""
    pass

class OnlyInstanceMethod:
    def __init__(self, func):
        self.func = func
        # 拷贝原函数元信息，避免装饰器丢失函数名、文档等属性
        self.__name__ = func.__name__
        self.__doc__ = func.__doc__
        self.__qualname__ = func.__qualname__

    def __get__(self, obj, objtype=None):
        if obj is None:
            raise InstanceMethodOnlyError(
                f"方法 {self.__qualname__} 为实例方法，禁止直接通过类 {objtype.__name__} 调用，请先创建实例后再调用"
            )
        return MethodType(self.func, obj)

# 可选：搭配元类实现自动包装，子类重写方法无需手动加装饰器
class AutoWrapInstanceMethodMeta(type):
    def __new__(cls, name, bases, namespace):
        for attr_name, attr_value in namespace.items():
            # 跳过特殊方法、类方法、静态方法，仅包装普通实例方法
            if (
                callable(attr_value)
                and not isinstance(attr_value, (classmethod, staticmethod))
                and not (attr_name.startswith("__") and attr_name.endswith("__"))
            ):
                namespace[attr_name] = OnlyInstanceMethod(attr_value)
        return super().__new__(cls, name, bases, namespace)

# 基类指定元类后，所有子类自动应用拦截逻辑
class Foo(metaclass=AutoWrapInstanceMethodMeta):
    def bar(self, x=None):
        print(x)

效果验证

• 合法实例调用：Foo().bar(42)正常输出42，无异常
• 非法类调用：Foo.bar(42)、子类直接类调用Baz1.bar(42)均抛出InstanceMethodOnlyError，符合预期
• 正常super调用：子类中不管是无参super还是显式传参super，因为全程绑定了实例self，均可正常执行，不会被误拦截
• 兼容性：完全遵循Python描述符协议，不会破坏多态、继承、super调用等原生数据模型逻辑

内容的提问来源于stack exchange，提问作者Jake Stevens-Haas