ComfyUI中ControlNet Aux插件深度模型加载问题解析

问题背景

在使用ComfyUI的ControlNet Aux插件时，部分用户遇到了深度模型文件加载失败的问题。具体表现为系统提示找不到指定路径下的模型文件，路径中包含了.incomplete后缀的临时文件。这类问题通常与文件下载中断或路径配置不当有关。

问题原因分析

经过技术排查，发现该问题主要由以下两个因素导致：

1. 路径长度限制：Windows系统对文件路径有最大长度限制（通常为260个字符）。当ComfyUI安装路径过长时，可能导致下载的模型文件无法正确保存。

2. 下载中断问题：HuggingFace模型库中的大文件下载时若被中断，会留下.incomplete临时文件，导致后续加载失败。

解决方案

方案一：缩短安装路径

建议用户将ComfyUI安装到较短的路径下，例如：

D:\ComfyUI\...

避免使用多层嵌套的目录结构，确保整个路径长度不超过Windows系统的限制。

方案二：清理缓存文件

若问题仍然存在，可以手动删除缓存目录：

1. 导航至ComfyUI安装目录下的custom_nodes/comfyui_controlnet_aux/ckpts/LiheYoung/Depth-Anything/.cache文件夹
2. 删除该文件夹中的所有内容
3. 重新启动ComfyUI并尝试再次加载模型

方案三：使用新版深度模型

技术社区推荐使用Depth Anything V2模型，该版本在性能和稳定性上都有显著提升。用户可以在ControlNet Aux插件中切换至新版模型，可能避免此类加载问题。

技术建议

1. 网络稳定性：下载大型模型文件时，确保网络连接稳定，避免中断。
2. 磁盘空间检查：确保目标磁盘有足够的存储空间容纳模型文件。
3. 权限设置：以管理员身份运行ComfyUI，确保有足够的权限写入目标目录。

总结

ComfyUI生态系统中插件模型加载问题大多可通过优化路径配置和清理缓存解决。对于深度计算这类需要大型模型文件的功能，建议用户关注模型更新动态，及时升级到更稳定的版本。同时，保持简洁的软件安装路径是预防此类问题的有效方法。