functools.partial 与方法绑定的非直觉行为

很多 Python 开发者觉得：

functools.partial

只是：

“提前固定几个参数”

但实际上：

它和 Python 的“方法绑定机制”组合后，会出现很多非常反直觉的行为。

尤其涉及：

实例方法

classmethod

staticmethod

descriptor

self 自动绑定

时。

很多线上 bug 都和这里有关。

一、先理解：Python 方法其实是 descriptor

例如：

class A:

def test(self, x):

print(self, x)

当你：

a = A()

a.test

得到的并不是原函数。

而是：

绑定方法（bound method）

Python 自动做了：

partial(A.test, a)

类似的事情。

也就是说：

self 已经提前绑定

了。

二、最经典陷阱：partial 实例方法

很多人这样写：

from functools import partial

class A:

def test(self, x, y):

print(x, y)

a = A()

p = partial(a.test, 1)

p(2)

输出：

1 2

这看起来正常。

但真正危险的是：

p = partial(A.test, 1)

p(2, 3)

输出：

2 3

为什么？

因为：

1 被当成 self

了。

也就是说：

partial(A.test, 1)

等价于：

A.test(1, ...)

而不是：

A().test(1, ...)

三、很多人误以为 partial 会“自动绑定 self”

但：

partial 不会触发 descriptor 协议

这是关键。

例如：

A.test

取出来时：

只是函数对象

不是绑定方法。

因此：

partial(A.test, 1)

只是单纯固定第一个参数。

四、bound method 与 unbound function 完全不同

看：

a.test

和：

A.test

差异。

a.test

类型：

它已经携带：

__self__ = a

A.test

类型：

完全没有绑定实例。

五、partial 会“冻结错误的 self”

一个非常隐蔽的问题：

class A:

def hello(self, name):

print(self, name)

a1 = A()

a2 = A()

p = partial(a1.hello, "Tom")

此时：

p()

永远使用：

a1

即使：

A.hello

后来被 monkey patch。

或者：

a1

状态变化。

很多框架热更新会踩这个坑。

六、partialmethod 才是真正的方法绑定工具

Python 专门提供：

functools.partialmethod

就是为了解决这个问题。

例如：

from functools import partialmethod

class A:

def test(self, x, y):

print(x, y)

test1 = partialmethod(test, 1)

现在：

a = A()

a.test1(2)

输出：

1 2

并且：

self 会自动绑定

七、为什么 partialmethod 能正常工作

因为：

partialmethod 是 descriptor

而：

partial

不是。

因此：

a.test1

访问时：

Python 会自动：

绑定 self

八、partial 放到类属性里会彻底异常

很多人这样：

class A:

def test(self, x, y):

print(x, y)

p = partial(test, 1)

然后：

a = A()

a.p(2)

会报错：

TypeError

因为：

a.p 不会自动绑定 self

原因：

partial 对象

不是 descriptor。

所以：

实例访问类属性时

不会触发方法绑定机制

九、这是 Python descriptor 的核心细节

函数对象：

function

实现了：

__get__()

所以：

a.test

时：

Python 自动创建：

bound method

而：

partial

没有实现 descriptor。

因此：

a.p

只是普通对象。

十、装饰器 + partial 更容易出事

例如：

def deco(fn):

return partial(fn, 1)

用于方法：

class A:

@deco

def test(self, x):

print(self, x)

然后：

a.test()

可能直接参数错位。

因为：

self 和 partial 固定参数发生冲突

十一、classmethod 更诡异

例如：

class A:

@classmethod

def test(cls, x):

print(cls, x)

然后：

p = partial(A.test, 1)

p()

输出：

1

因为：

A.test

已经是：

bound method

cls 已经绑定。

但：

partial(A.__dict__['test'], 1)

又完全不同。

因为：

classmethod 对象本身不是函数

十二、partial 会破坏 inspect.signature

例如：

from functools import partial

import inspect

def f(a, b, c):

pass

p = partial(f, 1)

print(inspect.signature(p))

输出：

(b, c)

但：

一些框架：

FastAPI

Click

Typer

dependency injection

会基于 signature 做分析。

复杂 partial 嵌套后：

参数推导可能异常

十三、pickle 问题

某些 partial：

partial(obj.method)

无法 pickle。

尤其：

multiprocessing

ProcessPoolExecutor

里。

因为：

bound method 可能不可序列化

十四、闭包有时比 partial 更安全

很多情况下：

def wrapper(x):

return func(1, x)

反而比：

partial(func, 1)

更稳定。

尤其涉及：

方法

descriptor

动态绑定

monkey patch

时。

十五、实战建议

类方法参数预绑定

优先：

partialmethod

而不是：

partial

回调函数

普通函数：

partial

问题不大。

框架开发

要注意：

signature

descriptor

pickle

self 绑定

动态系统

慎用：

partial(obj.method)

因为：

会冻结当前 method 状态