在Linux离线服务器用Python转TIF为JPG时出现OSError: -2

我需要将TIF格式图片转为JPG后用于OpenCV，该功能在本地系统运行正常，但在无网络连接的Linux服务器上执行时，保存Image对象为JPG格式的步骤失败。我使用Python3.8，已通过wheel文件在服务器上用pip安装了所有相关库及其依赖。

相关代码片段 #

import PIL
from PIL import Image  # 注：原代码遗漏此导入，否则Image.open会报错
import cv2

def face_detect(sourceImagepath1, processedFileName, imagename, pdfname):
    temp_path = TEMP_PATH
    processed_path = PROCESSED_PATH
    misc_path = MISC_PATH
    # cascade文件路径
    cascpath1 = misc_path + 'frontalface_cascade.xml'
    # 创建haar级联分类器
    faceCascade = cv2.CascadeClassifier(cascpath1)
    # 用PIL读取图片
    image_pil = Image.open(sourceImagepath1)
    # 保存为JPG格式
    image_pil.save(temp_path + processedFileName + '.jpg')
    # 用OpenCV读取图片
    image_cv = cv2.imread(temp_path + processedFileName + '.jpg')
    # 转为灰度图
    image_gray = cv2.cvtColor(image_cv, cv2.COLOR_BGR2GRAY)

    # 检测人脸
    face = faceCascade.detectMultiScale(
        image_gray,
        scaleFactor=1.3,
        minNeighbors=5,
        minSize=(30, 30)
        # flags = cv2.CASCADE_SCALE_IMAGE
    )

    if len(face) > 0:
        # 自动检测的人脸坐标
        x, y, w, h = face[0][0], face[0][1], face[0][2], face[0][3]
        crop_image = image_pil.crop([x - 20, y - 30, x + w + 40, y + h + 60])
        crop_image.save(processed_path + imagename)
    # 保存TIF为PDF
    image_pil.save(processed_path + pdfname, save_all=True)
    # 关闭图片对象
    image_pil.close()
    return len(face)

其中TEMP_PATH、PROCESSED_PATH、MISC_PATH为类似'/Users/user/Documents/Temp/'的全局变量。

错误发生位置 #

错误出现在以下代码行：

image_pil.save(temp_path + processedFileName + '.jpg')

报错信息 #

Traceback (most recent call last):
  File "*path_from_root_directory*/PYTHON_SCRIPTS/Script/staging.py", line 363, in <module>
    auto_face_count = face_detect(sourceImagepath1, processedFileName, imagename, pdfname)
  File "*path_from_root_directory*/PYTHON_SCRIPTS/Script/staging.py", line 71, in greyScaleCheck
    image_pil.save(temp_path + processedFileName + '.jpg')
  File "*path_from_root_directory*/python3.8/site-packages/PIL/Image.py", line 2201, in save
    self._ensure_mutable()
  File "*path_from_root_directory*/python3.8/site-packages/PIL/Image.py", line 624, in _ensure_mutable
    self._copy()
  File "*path_from_root_directory*/python3.8/site-packages/PIL/Image.py", line 617, in _copy
    self.load()
  File "*path_from_root_directory*/python3.8/site-packages/PIL/TiffImagePlugin.py", line 1122, in load
    return self._load_libtiff()
  File "*path_from_root_directory*/python3.8/site-packages/PIL/TiffImagePlugin.py", line 1226, in _load_libtiff
    raise OSError(err)
OSError: -2

我已为Python目录及其子目录/文件赋予完全权限，请问出现该错误的原因是什么？

原因分析及解决建议 #

可能原因 #

• 系统级libtiff依赖缺失：报错来自PIL的Tiff插件调用libtiff加载图片，说明服务器上缺少系统级的libtiff库。虽然用wheel安装了Pillow，但wheel可能未包含系统底层依赖，无网环境下系统默认可能没预装libtiff。
• TIF格式兼容性问题：部分TIF图片采用特殊编码（如LZW压缩、16位色深、多页等），本地系统的libtiff支持这些编码，但服务器上的libtiff未启用对应解码器。
• 临时目录权限不足：虽然给了Python目录权限，但TEMP_PATH指向的服务器目录可能不存在，或当前运行脚本的用户无写入权限。
• Pillow版本差异：本地和服务器的Pillow版本不一致，新版本/旧版本对TIF的处理逻辑存在兼容bug。

解决建议 #

1. 安装系统级libtiff库：如果有离线安装包（如.rpm/.deb），在服务器上安装对应版本的libtiff及开发包。例如CentOS执行yum install libtiff-devel，Ubuntu执行apt install libtiff5-dev（需提前下载好离线依赖包）。
2. 预处理TIF图片：读取TIF后先转为RGB模式再保存，规避特殊格式问题：

image_pil = Image.open(sourceImagepath1).convert("RGB")
image_pil.save(temp_path + processedFileName + '.jpg')

3. 检查临时目录权限：验证TEMP_PATH对应的服务器路径是否存在，执行ls -ld <temp_path>查看权限，确保运行脚本的用户有读写权限。
4. 对齐Pillow版本：安装和本地环境完全相同版本的Pillow，用离线wheel包重新安装，避免版本差异导致的问题。

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