‘NoneType’ object has no attribute ‘encode_image’
快速结论：此报错通常发生在 ComfyUI 的 IPAdapter Apply 节点工作时。优先检查你输入给 IPAdapter 的 CLIP Vision 模型是否正确加载，以及图片输入是否有效。
问题场景
用户在 ComfyUI 中使用 ComfyUI_IPAdapter_plus 自定义节点时，执行 IPAdapter Apply 节点触发此错误。报错指向代码 clip_vision.encode_image(image) 这一行。
报错原文
Error occurred when executing IPAdapterApply:
'NoneType' object has no attribute 'encode_image'
File "E:\ComfyUI-aki-v1\custom_nodes\ComfyUI_IPAdapter_plus\IPAdapterPlus.py", line 636, in apply_ipadapter
clip_embed = clip_vision.encode_image(image)
原因分析
这个报错意味着 clip_vision 对象为 None，因此无法调用 encode_image 方法。
可能原因包括：
- CLIP Vision 模型未正确加载——可能是模型文件缺失、下载不完整或路径不对。
- 使用的图片模型（如 CLIP Vision 相关模型）与你当前的 ComfyUI 或 IPAdapter Plus 节点版本不兼容。
- 插件或依赖未正确安装，导致节点无法获取有效的 vision 模型实例。
需注意：与你使用的模型有关，不适配就可能会出现这个报错（来自 Issue 评论）。
环境排查
- 确认 ComfyUI 版本（建议更新到最新版）。
- 确认 ComfyUI_IPAdapter_plus 插件版本（建议从 GitHub 拉取最新代码）。
- 检查 CLIP Vision 模型文件是否完整（常见模型如
CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors或CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensors），并放置在ComfyUI/models/clip_vision/目录下。 - 确认加载工作流时，图片节点输出通道正常，且图片不为空。
解决步骤
- 重新下载 CLIP Vision 模型：删除已有的 CLIP Vision 模型文件，从官方源或可信镜像重新下载，确保文件大小一致、无损坏。
- 更新 ComfyUI 和插件：分别更新 ComfyUI 主程序及 ComfyUI_IPAdapter_plus 节点到最新版本。
- 检查 Workflow 连接：确保 IPAdapter Apply 节点的模型输入（model）、图像输入（image）、以及 CLIP Vision 输入（clip_vision）都正确连线，无遗漏或悬空。
- 测试不同模型：如果手头有多个 CLIP Vision 模型，尝试切换一个已知兼容的模型（例如 CLIP-ViT-H-14-laion2B-s32B-b79K），以排除模型兼容性问题。
- 检查依赖：确认已正确安装 ComfyUI 所需的所有依赖（如 torch、torchvision、diffusers、transformers 等），可尝试在 ComfyUI 环境内重新安装插件。
- 以上步骤无效时，可参考 Issue #108 中的常见问题汇总：https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/108。
验证方法
重启 ComfyUI，重新加载含有 IPAdapter Apply 节点的工作流，再次执行推理。如果不再出现 'NoneType' object has no attribute 'encode_image' 报错，且 IPAdapter 节点正常输出，则问题已解决。
参考来源
cubiq/ComfyUI_IPAdapter_plus #241
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
