Python中使用libtiff库如何避免递归深度超限运行时错误

我之前也碰到过一模一样的问题！你排查到的TIFFExtender类递归问题是libtiff_ctypes的经典坑——当在类方法而非全局/main函数上下文里调用TIFF.open()时，TIFFExtender的__init__方法会触发无限递归。

问题根源拆解 #

TIFFExtender的设计目标是自动给TIFF实例扩展额外方法，但它的__init__里的extender_pyfunc函数在绑定方法时，会反复触发自身的初始化逻辑。当你在类方法中创建TIFF对象时，这个绑定过程会陷入无限递归，直到Python触发递归深度限制。而main函数里没问题，是因为全局上下文的方法绑定不会触发这个循环。

你尝试的del和gc.collect()没用，是因为问题出在对象创建阶段，不是内存泄漏，垃圾回收根本没机会介入。

具体解决方案 #

这里有几个可行的修复方案，按优先级排序：

1. 绕过TIFFExtender的自动扩展（最快修复）

直接使用libtiff的底层接口，跳过TIFFExtender的自动方法绑定。修改你代码里的TIFF实例化部分：

# 替换原来的TIFF.open调用
from libtiff import libtiff
# 直接用C级别的TIFF打开函数
__tif = libtiff.TIFFOpen(fn, 'r')

这样就完全避开了TIFFExtender的递归问题，不过你需要手动处理一些原来由扩展提供的方法（比如get_numpy_type，可以自己实现一个简单版本：

def get_numpy_type(bits_per_sample, sample_format):
    if sample_format == 1: # 无符号整数
        return np.uint8 if bits_per_sample ==8 else np.uint16 if bits_per_sample ==16 else np.uint32
    elif sample_format ==2: # 有符号整数
        return np.int8 if bits_per_sample ==8 else np.int16 if bits_per_sample ==16 else np.int32
    elif sample_format ==3: # 浮点
        return np.float32 if bits_per_sample ==32 else np.float64

2. 临时禁用TIFFExtender的递归绑定

如果必须用TIFFExtender提供的方法，可以在你的代码开头添加一段猴子补丁，阻止递归循环：

# 在你的代码开头添加这段monkey-patch
from libtiff.libtiff_ctypes import TIFFExtender

original_init = TIFFExtender.__init__
def patched_init(self, obj):
    # 只绑定一次，避免递归
    if hasattr(obj, '_extender_bound'):
        return
    original_init(self, obj)
    setattr(obj, '_extender_bound', True)

TIFFExtender.__init__ = patched_init

这个补丁会给TIFF实例添加一个标记，确保TIFFExtender只初始化一次，彻底阻断递归。

3. 重构代码，把TIFF操作移到全局函数

把你的TIFF读取逻辑封装成独立的全局函数，在类方法里调用这个函数，而不是直接在方法内实例化TIFF对象：

def read_tiff_file(fn):
    # 原来的TIFF读取逻辑放在这里
    extra_tags = [
        TIFFFieldInfo(297, 2, 2, TIFFDataType.TIFF_SHORT, FIELD_CUSTOM, True, False, "PageNumber"),
        # 其他标签定义...
    ]
    add_tags(extra_tags)
    __tif = TIFF.open(fn, mode='r')
    # 后续的参数获取、读取逻辑...
    return image_data

# 然后在类方法里调用：
def your_class_method(self):
    datapath = r'D:\Userdata\username\prjname\subprj\tiffs'
    files = ['CRFVOL1', 'CRFVOL2', 'FC1', 'WP1', 'FC2', 'WP2']
    for filename in files:
        full_path = os.path.join(datapath, filename + '.tif')
        image_data = read_tiff_file(full_path)
        # 处理image_data

这样TIFF实例化发生在全局函数上下文，不会触发TIFFExtender的递归。

针对你代码的额外建议 #

看你的代码里定义了很多全局变量（__ncols, __nrows等），这些全局变量在批量处理时很容易引发状态混乱，建议把它们封装到一个类或者数据结构里，避免全局状态污染。比如用一个TiffReader类来封装所有读取逻辑和状态变量。

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