Python模块包装函数触发TypeError：'module'对象不可调用

核心原因拆解 #

这种报错通常是包装逻辑中不小心让闭包捕获了模块对象，或是误将模块/子模块当作函数包装——哪怕你看到type(mod.f)显示为function，包装后的函数内部实际调用的可能是模块对象，而非目标函数。

常见坑点与修复方案 #

1. 循环遍历的闭包陷阱（最常见） #

如果你的包装逻辑是类似下面的循环写法：

def wrap_module_with_warnings(mod):
    for name in dir(mod):
        item = getattr(mod, name)
        if callable(item) and not name.startswith('_'):
            def wrapper(*args, **kwargs):
                print(f"Warning: {name} is called")
                return item(*args, **kwargs)
            setattr(mod, name, wrapper)

问题出在：闭包里的item会捕获循环的最后一个值。如果遍历到的最后一个成员是模块（比如模块内部导入的子模块），wrapper里调用的就会是模块对象，触发报错。

修复方式：用默认参数固定闭包变量的值：

def wrapper(*args, **kwargs, item=item):
    print(f"Warning: {name} is called")
    return item(*args, **kwargs)

或者用独立函数封装，避免变量捕获问题：

def make_wrapper(target_func, func_name):
    def wrapper(*args, **kwargs):
        print(f"Warning: {func_name} is called")
        return target_func(*args, **kwargs)
    return wrapper

# 循环内替换为：
setattr(mod, name, make_wrapper(item, name))

2. 误包装模块对象 #

检查包装逻辑的判断条件，是否把模块/子模块当成了函数处理。可以加上类型过滤，只处理函数和方法：

import types

# 修改判断条件
if isinstance(item, (types.FunctionType, types.MethodType)) and not name.startswith('_'):
    # 执行包装逻辑

3. 类方法绑定异常 #

如果模块内有类，直接替换类方法会丢失实例绑定关系，可能导致隐性的调用错误。需要用functools.wraps保留原方法元数据，确保绑定正常：

from functools import wraps

def wrap_class_method(method, method_name):
    @wraps(method)
    def wrapper(self, *args, **kwargs):
        print(f"Warning: {method_name} is called")
        return method(self, *args, **kwargs)
    return wrapper

验证调试方法 #

包装后可以打印函数的闭包内容，确认内部引用的对象：

print(mod.f.__closure__)

如果闭包的cell引用是模块对象，就可以确定是闭包陷阱的问题，按上述方案修复即可。

内容的提问来源于stack exchange，提问作者Green 绿色