高频错误
ComfyUI 缺少 piexif 模块
解决 ComfyUI 启动时报 No module named piexif 错误的方法
错误信息
ComfyUI 启动时,终端日志中出现以下错误之一:
ModuleNotFoundError: No module named 'piexif'
Cannot import ... module for custom nodes: No module named 'piexif'
原因
piexif 是一个纯 Python 的 EXIF 图片元数据读写库。多个常用插件依赖它来在生成的图片中保存工作流信息,包括:
- ComfyUI-Impact-Pack
- save-image-extended-comfyui
- ComfyUI_Comfyroll_CustomNodes
- comfyui-prompt-reader-node
缺少 piexif 时,相关插件无法加载,但 ComfyUI 核心功能不受影响。
严重程度
低 -- 仅影响需要读写图片元数据的插件。
解决方法
在 Wonderful Launcher 的「环境」页面打开终端,执行:
pip install piexif
安装完成后重启 ComfyUI 即可。
备注
piexif 最新版本为 1.1.3,是纯 Python 包,无需编译,安装不会遇到 C 编译器相关问题。该库更新较慢但功能稳定,ComfyUI 生态中广泛使用。
仍然无法解决?
请通过应用内的「联系我们」按钮联系技术支持。
Wonderful Launcher 文档