Pillow库处理TIFF图像EXIF数据时的注意事项

背景介绍

Pillow(Python Imaging Library)是Python生态中广泛使用的图像处理库。在处理地理科学数据时，开发者经常需要将坐标信息存储在TIFF图像的EXIF元数据中。近期Pillow 10.2及以上版本在处理这类需求时出现了一些兼容性问题，本文将详细分析问题原因并提供解决方案。

问题现象

在使用Pillow 10.2及以上版本时，开发者发现原本能够正常工作的TIFF图像保存和加载代码突然失效。具体表现为：

1. 当尝试保存包含特定EXIF标签的TIFF图像时，系统抛出NotImplementedError: multistrip support not yet implemented错误
2. 问题主要出现在设置了ROWSPERSTRIP标签(编号278)且使用压缩选项的情况下

技术分析

EXIF标签处理机制变化

Pillow 10.2版本引入了一个重要变更：允许用户显式设置ROWSPERSTRIP标签(编号278)。这个标签用于指定TIFF图像中每个条带(strip)包含的行数。

多条带支持限制

当开发者设置的ROWSPERSTRIP值小于图像高度时，理论上图像应该被分割为多个条带存储。然而，Pillow目前尚未实现多条带支持功能，因此会抛出NotImplementedError异常。

压缩选项的影响

使用compression='tiff_deflate'等压缩选项时，Pillow对图像数据的处理更为严格，会检查并尝试应用所有指定的EXIF标签，包括ROWSPERSTRIP，从而更容易触发上述限制。

解决方案

方案一：移除ROWSPERSTRIP标签

最简单的解决方案是从EXIF数据中移除ROWSPERSTRIP标签(编号278)。这样Pillow会使用默认的条带设置，避免触发多条带支持检查。

# 修改前的标签字典
tag = {
    278: (5,),  # 这个标签会导致问题
    # 其他标签...
}

# 修改后的标签字典(移除278)
tag = {
    # 其他标签...
}

方案二：使用兼容的Pillow版本

如果代码中有多处使用ROWSPERSTRIP标签且难以全部修改，可以暂时将Pillow版本固定在10.1.x系列：

pip install Pillow==10.1.0

方案三：使用ExifTags模块提高代码可读性

虽然与核心问题无关，但建议使用Pillow提供的ExifTags模块来管理EXIF标签，提高代码可读性和可维护性：

from PIL import ExifTags

tag = {
    ExifTags.Base.ImageWidth: (128,),
    ExifTags.Base.ImageLength: (128,),
    # 其他标签...
}

最佳实践建议

1. 谨慎使用低级标签编号：尽量使用ExifTags模块定义的常量而非直接使用数字编号
2. 测试不同压缩选项：在使用压缩选项前，先测试是否会影响EXIF数据的读写
3. 关注版本更新：定期检查Pillow的更新日志，了解可能影响现有功能的变更
4. 异常处理：对图像保存操作添加适当的异常处理，特别是当使用自定义EXIF数据时

总结

Pillow库在10.2版本后对TIFF的EXIF处理更加严格，特别是对ROWSPERSTRIP标签的支持变化导致了兼容性问题。开发者可以通过调整EXIF数据内容或暂时使用旧版本解决当前问题。长期来看，关注官方更新并适时实现多条带支持将是更彻底的解决方案。