PySide6信号为何能调用签名不匹配的槽函数？

问题场景1：无参槽函数接收带参数的信号 #

在以下代码中，QSpinBox.valueChanged信号会传递一个int类型参数，但无参的槽函数fun()却能被正常调用，这是为什么？

from PySide6.QtWidgets import QApplication, QSpinBox

def fun():
    print("This works, but why? box.valueChanged passes an int!")

app = QApplication()
box = QSpinBox()
box.valueChanged.connect(fun)
box.setValue(10)

问题场景2：装饰器导致的参数错误 #

当给槽函数添加装饰器后，运行时会抛出如下错误：

TypeError: decorated_fun() takes 0 positional arguments but 1 was given.

对应的代码：

from PySide6.QtWidgets import QApplication, QSpinBox

def fun():
    print("This works, but why?")

def my_decorator(inner):
    def wrapper(*args, **kwargs):
        return inner(*args, **kwargs)
    return wrapper

@my_decorator
def decorated_fun():
    print("This fails")

app = QApplication()
box = QSpinBox()
box.valueChanged.connect(fun)
box.valueChanged.connect(decorated_fun)
box.setValue(10)

即使使用decorator库，也会出现相同的错误：

from decorator import decorator
from PySide6.QtWidgets import QApplication, QSpinBox

def fun():
    print("This works, but why?")

@decorator
def my_decorator(inner, *args, **kwargs):
    return inner(*args, **kwargs)

@my_decorator
def decorated_fun():
    print("This fails")

app = QApplication()
box = QSpinBox()
box.valueChanged.connect(fun)
box.valueChanged.connect(decorated_fun)
box.setValue(10)

问题解答 #

1. PySide6为何能调用无参槽函数 #

PySide6的信号槽机制内置了参数自动适配逻辑：

• 建立连接时，会检查槽函数与信号的参数数量。
• 如果槽函数接受的参数数量 ≤ 信号传递的参数数量，且前N个参数类型兼容（N为槽函数的参数数），PySide6会自动截断多余参数，仅传递槽函数能处理的部分。
• 对于无参槽函数，PySide6会直接调用它，不传递任何信号参数，这是Qt为提升开发灵活性设计的兼容行为。

2. 装饰器导致错误的原因 #

普通装饰器返回的包装函数（如示例中的wrapper）参数签名为*args, **kwargs（可变参数）。PySide6会识别到该函数可接受任意数量的参数，因此会将信号的int参数传递给它。而包装函数会把所有接收到的参数转发给无参的原始函数decorated_fun，最终触发参数不匹配的TypeError。

3. 能否禁用这种参数兼容行为 #

可以通过StrictConnection连接类型禁用该兼容行为：

• 使用Qt.ConnectionType.StrictConnection时，信号与槽的参数必须严格匹配（数量、类型均一致），否则连接会直接失败，避免运行时出现意外。
• 修改后的连接代码示例：

from PySide6.QtCore import Qt
# ... 其他代码 ...
box.valueChanged.connect(fun, Qt.ConnectionType.StrictConnection)

如果此时槽函数参数与信号不匹配，程序会在建立连接时就抛出错误，而非运行时触发异常。

内容的提问来源于stack exchange，提问作者bers