如何安全地将 PIL 提取的 EXIF 元数据序列化为 JSON-Python教程-PHP中文网

如何安全地将 PIL 提取的 EXIF 元数据序列化为 JSON

PIL 的 IFDRational 类型（如曝光时间、焦距等）无法被 json.dumps() 直接序列化，且其可能嵌套在 GPSInfo 等字典结构中；需递归遍历并转换所有 IFDRational、字节串及容器类型，才能生成合法 JSON。

如何安全地将 pil 提取的 exif 元数据序列化为 json：pil 的 `ifdrational` 类型（如曝光时间、焦距等）无法被 `json.dumps()` 直接序列化，且其可能嵌套在 `gpsinfo` 等字典结构中；需递归遍历并转换所有 `ifdrational`、字节串及容器类型，才能生成合法 json。

在使用 Pillow（PIL）解析图像 EXIF 元数据时，常遇到 TypeError: Object of type IFDRational is not JSON serializable 错误。该错误的根本原因在于：IFDRational 是 Pillow 内部用于精确表示有理数（如 300/1 表示 300 dpi）的类，而 Python 标准 json 模块仅支持基础类型（str, int, float, list, dict, bool, None）。更关键的是，IFDRational 不仅出现在 EXIF 顶层键值中，还常深度嵌套于 GPSInfo、MakerNote 等子字典或列表内——仅对顶层值做 float() 转换无法覆盖全部场景。

以下是一个健壮、可复用的解决方案，通过递归清洗函数 sanitise_value() 统一处理所有潜在非序列化类型：

import json
from PIL import Image, TiffImagePlugin
import PIL.ExifTags

def sanitise_value(value):
    # 1. IFDRational → float（保留数值精度，丢弃有理数结构）
    if isinstance(value, TiffImagePlugin.IFDRational):
        return float(value)

    # 2. dict → 递归清洗所有 value
    if isinstance(value, dict):
        return {k: sanitise_value(v) for k, v in value.items()}

    # 3. list/tuple → 递归清洗每个元素，并统一转为 list（JSON 不支持 tuple）
    if isinstance(value, (list, tuple)):
        return [sanitise_value(item) for item in value]

    # 4. bytes/bytearray → 解码为 str（推荐 utf-8 + replace 策略防乱码）
    if isinstance(value, (bytes, bytearray)):
        return value.decode("utf-8", "replace")

    # 5. 其他类型（str, int, float, bool, None）直接返回
    return value

# 使用示例
img = Image.open("/home/user/DSCN0010.jpg")
exif_raw = img._getexif()

if exif_raw is None:
    print("No EXIF data found.")
else:
    # 映射 TAGS 并清洗所有值（含嵌套）
    exif_dict = {
        PIL.ExifTags.TAGS.get(k, k): sanitise_value(v)
        for k, v in exif_raw.items()
        if k in PIL.ExifTags.TAGS
    }

    # 安全序列化
    print(json.dumps(exif_dict, indent=2, ensure_ascii=False))

✅ 关键特性说明：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

完全递归：自动穿透 GPSInfo、MakerNote 等任意深度嵌套结构；
类型全覆盖：除 IFDRational 外，显式处理 bytes（常见于 UserComment）、tuple（Pillow 偶尔返回）等易遗漏类型；
安全解码：对字节串采用 "utf-8", "replace" 策略，避免因编码不匹配导致崩溃（如日文注释），亦可按需替换为 "latin-1" 或 "ignore"；
健壮性增强：添加 exif_raw is None 检查，防止无 EXIF 图像报错；使用 TAGS.get(k, k) 保留未知 TAG 编号，避免 KeyError。

⚠️ 注意事项：

img._getexif() 是私有方法（带下划线），虽当前稳定，但未来 Pillow 版本可能调整。生产环境建议改用 img.getexif()（Pillow 8.2+），其返回 Exif 对象，需先调用 .values() 或 .items() 转为字典再处理；
IFDRational 转 float 会损失精度（如 1/3 变为 0.3333333333333333），若需高精度有理数存储，请改用 str(v) 或自定义序列化（如 {"numerator": v.numerator, "denominator": v.denominator}）；
GPS 坐标（GPSInfo 中的 GPSLatitude/GPSLongitude）通常为 (deg, min, sec) 元组，清洗后变为 [float, float, float]，后续需额外转换为十进制度数。