‘NoneType’ object has no attribute ‘encode_image’

快速结论：在 ComfyUI 中执行 IPAdapterApply 节点时，若节点传给 IPAdapter 的 CLIP Vision 模型未正确加载或不匹配，就会在 clip_vision.encode_image(image) 处抛出 'NoneType' object has no attribute 'encode_image'。优先排查 CLIP Vision 模型是否已放入正确目录、文件名是否与节点加载结果一致。

适用环境：ComfyUI（Issue 中路径为 ComfyUI-aki-v1，Windows），插件为 ComfyUI IPAdapter Plus，执行节点为 IPAdapterApply。Issue 未提供 Python、PyTorch、CUDA、显卡等版本信息。

最快修复方案：暂无确认的一步修复方案。维护者在 Issue 中明确要求先检索已关闭 Issue 与常见问题（#108），并指出该问题已被多次讨论；结合评论中“和你使用的模型有关系，不适配就会可能出现这个报错”，可优先尝试核对并更换与 IPAdapter 适配的 CLIP Vision 模型后重试。

注意事项：Issue 中仅确认了报错位置和“模型不适配”这一方向性说法，未给出具体模型文件名或版本；更换模型可能无法覆盖所有情况，仍需结合插件常见问题页面排查。

问题场景

用户在 ComfyUI 中运行 IPAdapter Plus 插件，使用 IPAdapterApply 节点处理图像时触发报错。用户已尝试重装插件、重新下载模型与依赖，甚至用云服务器上可正常运行的文件进行替换，问题仍未解决。该 Issue 在 2024-01-22 被关闭。

报错原文

Error occurred when executing IPAdapterApply:
'NoneType' object has no attribute 'encode_image'

File "E:\ComfyUI-aki-v1\execution.py", line 153, in recursive_execute
output_data, output_ui = get_output_data(obj, input_data_all)
File "E:\ComfyUI-aki-v1\execution.py", line 83, in get_output_data
return_values = map_node_over_list(obj, input_data_all, obj.FUNCTION, allow_interrupt=True)
File "E:\ComfyUI-aki-v1\execution.py", line 76, in map_node_over_list
results.append(getattr(obj, func)(**slice_dict(input_data_all, i)))
File "E:\ComfyUI-aki-v1\custom_nodes\ComfyUI_IPAdapter_plus\IPAdapterPlus.py", line 636, in apply_ipadapter
clip_embed = clip_vision.encode_image(image)

原因分析

报错发生在 IPAdapterPlus.py 第 636 行，说明调用 encode_image 时，clip_vision 这个对象为 None，即 CLIP Vision 编码器没有被成功加载。可能原因包括：CLIP Vision 模型文件未放置到插件预期的位置、文件名与实际加载逻辑不匹配、所选的 CLIP Vision 模型与当前 IPAdapter 模型不适配等。评论中也有用户提到“和你使用的模型有关系，不适配就会可能出现这个报错”。

环境排查

确认 ComfyUI 安装路径与插件目录：Issue 中路径为 E:\ComfyUI-aki-v1\custom_nodes\ComfyUI_IPAdapter_plus，需确认插件目录结构完整。
确认 CLIP Vision 模型是否已正确放置在插件要求的位置，文件名是否与节点加载列表一致。
确认当前使用的 IPAdapter 模型与 CLIP Vision 模型是否配套（评论指出模型不适配可能导致该报错）。
检查节点中加载的 CLIP Vision 是否实际选中了文件，而不是留空或指向不存在的文件。
Issue 未提供 Python、PyTorch、CUDA、显卡等版本，暂无法据此判断依赖版本问题。

解决步骤

先阅读插件维护者指出的常见问题页面与已关闭同类 Issue，确认是否属于已知配置问题。
检查 IPAdapterApply 节点所依赖的 CLIP Vision 模型是否已下载并放入插件预期目录，文件名与节点下拉列表中的名称一致。
确认当前 IPAdapter 模型与 CLIP Vision 模型是否配套；可优先尝试更换为与 IPAdapter 适配的 CLIP Vision 模型后重试。
如果使用的是整合包或云服务器替换过来的文件，需逐一核对路径与文件名是否与原环境一致，避免因路径不同导致仍然加载不到模型。

验证方法

重新执行 IPAdapterApply 节点，若不再出现 'NoneType' object has no attribute 'encode_image'，且图像能正常进入 IPAdapter 处理流程，说明 CLIP Vision 已被正确加载。若仍报同一错误，说明 clip_vision 仍未加载成功，需要继续核对模型路径、文件名与模型匹配关系。