如何解决 PIL 无法将 TIFF 图像转换为字节数组的问题

星强小哥_2702

星强小哥_2702

2026-04-10

861人浏览

原创

如何解决 PIL 无法将 TIFF 图像转换为字节数组的问题

当使用 pil 处理某些 tiff 图像时,因元数据(如 oldsubfiletype 标签)或不兼容的压缩方式导致 image.save() 报错(如 “error setting from dictionary”),可通过 numpy 中转剥离元数据后安全导出字节数组。

当使用 pil 处理某些 tiff 图像时,因元数据(如 oldsubfiletype 标签)或不兼容的压缩方式导致 image.save() 报错(如 “error setting from dictionary”),可通过 numpy 中转剥离元数据后安全导出字节数组。

在使用 PIL.Image 处理 TIFF 文件时,常见问题并非源于图像像素本身,而是其携带的 libtiff 不支持的私有标签、过时字段(如 OldSubfileType)或特殊压缩方案(如 LZW 变体、JPEG-in-TIFF)。这些信息在 image.save() 写入内存流(如 BytesIO)时触发底层 libtiff 库警告甚至崩溃,表现为:

_TIFFVSetField: Ignored tag "OldSubfileType" (not supported by libtiff)
Error setting from dictionary

直接调用 im.save('out.tif') 失败,意味着 io.BytesIO() 流同样会失败——因为二者共享同一套 TIFF 编码逻辑。

✅ 推荐解决方案:通过 NumPy 进行“像素级净化”中转
该方法本质是将图像解码为原始像素数组(np.ndarray),再以纯净状态重建 PIL Image 对象,从而彻底丢弃所有不可序列化的元数据与非标准标签:

import numpy as np
from PIL import Image
import io

def image_to_byte_array(image: Image.Image) -> bytes:
    # 关键步骤:剥离元数据 → 转为 numpy 数组 → 重建 PIL Image
    cleaned_image = Image.fromarray(np.array(image))

    img_byte_arr = io.BytesIO()
    # 显式指定 format='TIFF'(避免依赖 image.format,可能为 None 或不安全)
    cleaned_image.save(img_byte_arr, format='TIFF')
    return img_byte_arr.getvalue()

# 使用示例
im = Image.open(r"your_image.tiff")
im_bytes = image_to_byte_array(im)
print(f"Byte array size: {len(im_bytes)} bytes")  # 验证成功生成

⚠️ 注意事项与补充建议:

  • 色彩模式一致性:若原图是 'I;16'(16位灰度)或 'RGBA' 等非标准模式,np.array() 默认转为 uint8(可能截断)。需显式保留深度:
    arr = np.array(image)  # 对于 16-bit 图,arr.dtype 可能已是 uint16
    cleaned_image = Image.fromarray(arr, mode=image.mode)  # 显式传入 mode
  • 性能权衡:中转 NumPy 会触发一次完整像素拷贝,对超大 TIFF(如遥感影像)可能增加内存开销;生产环境可结合 image.convert('RGB') 或 .convert('L') 提前降维。
  • 替代方案(进阶):若需保留部分元数据(如地理坐标),可改用 tifffile 库直接读写:
    import tifffile
    with io.BytesIO() as buf:
        tifffile.imwrite(buf, np.array(image), photometric='rgb')
        return buf.getvalue()

总结:PIL 的 TIFF 写入健壮性受限于底层 libtiff 实现,而 NumPy 中转是轻量、可靠且无需额外依赖的通用规避策略。它不修复 TIFF 规范问题,但确保你总能获得一个可序列化的、仅含像素的有效图像对象。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1891

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5224

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1829

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

31597

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3747

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3747

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1263

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

616

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2903

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习