配置Python logging后为何无法获取Pillow调试日志？

你遇到的问题很常见——Pillow确实把旧的PIL.Image.DEBUG替换成了Python的logging模块，但直接设置root日志级别并不会自动捕获Pillow的调试输出，原因在于Pillow使用了独立的日志器来记录自己的日志信息，而不是直接复用root日志器。

要正确查看Pillow的调试日志，你需要针对它专属的日志器进行配置，具体步骤如下：

1. 定位Pillow的日志器 #

Pillow内部所有的调试日志都是通过名为PIL的日志器输出的，部分子模块（比如TIFF处理相关的TiffImagePlugin）会使用更细分的日志器（如PIL.TiffImagePlugin）。

2. 配置日志级别与处理器 #

你需要手动获取这个日志器，设置它的级别为DEBUG，并确保它有可用的日志处理器（用来输出日志到控制台或文件）。

下面是修正后的完整代码示例：

import logging

# 获取Pillow专属的日志器
pil_logger = logging.getLogger('PIL')
# 设置日志级别为DEBUG，捕获所有调试信息
pil_logger.setLevel(logging.DEBUG)

# 为日志器添加一个控制台处理器（避免依赖root日志器的配置）
if not pil_logger.handlers:
    handler = logging.StreamHandler()
    # 可选：设置日志格式，方便区分来源
    formatter = logging.Formatter('%(levelname)s [%(name)s]: %(message)s')
    handler.setFormatter(formatter)
    pil_logger.addHandler(handler)

# 测试日志输出
logging.debug('Test')

from PIL import Image
Image.open('my_picture.tif').show()

额外说明 #

如果需要查看某一子模块的更详细日志（比如只看TIFF解码的调试信息），可以单独针对子日志器配置：

tiff_logger = logging.getLogger('PIL.TiffImagePlugin')
tiff_logger.setLevel(logging.DEBUG)

这样配置后，你就能看到Pillow在处理图片过程中输出的所有调试日志了。

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