ComfyUI_ControlNet_Aux项目中TEED预处理器路径过长问题的解决方案
【免费下载链接】comfyui_controlnet_aux 
项目地址: https://gitcode.com/gh_mirrors/co/comfyui_controlnet_aux
问题背景
在使用ComfyUI_ControlNet_Aux项目时，部分Windows用户可能会遇到TEED预处理器无法正常工作的问题，系统报错显示"WinError 206 - 文件名或扩展名太长"。这个问题的根源在于Windows系统对文件路径长度的限制。
技术原理分析
Windows操作系统默认对文件路径长度有260个字符的限制（MAX_PATH）。当ComfyUI_ControlNet_Aux尝试从HuggingFace下载并缓存模型文件时，由于项目路径层级较深，加上模型文件名，很容易超过这个限制。
具体来说，完整的模型文件路径通常包含：
- ComfyUI安装目录
- 自定义节点目录
- HuggingFace缓存目录结构
- 模型版本快照目录
- 最终模型文件名
这些部分组合起来很容易超过260个字符的限制，特别是在便携版安装或深层目录结构的情况下。
解决方案
方法一：启用Windows长路径支持
- 按下Win+R组合键，输入"gpedit.msc"打开组策略编辑器
- 导航至：计算机配置 > 管理模板 > 系统 > 文件系统
- 找到"启用Win32长路径"策略并启用
- 应用设置并重启系统
此方法直接解除系统对路径长度的限制，是最彻底的解决方案。
方法二：自定义模型下载路径
- 在ComfyUI_ControlNet_Aux目录下创建config.yaml文件
- 添加以下内容指定新的模型存储位置：
CKPT_DIR: "更短的路径/ckpts" - 确保新路径的总长度足够短，避免再次超出限制
方法三：手动下载模型文件
- 从HuggingFace直接下载所需的模型文件（如7_model.pth）
- 将其放置在ComfyUI_ControlNet_Aux的ckpts目录下对应的子目录中
- 路径结构应为：ckpts/用户名/模型名/Annotators/模型文件
注意事项
- Windows 11家庭版可能没有组策略编辑器，需要使用注册表修改
- 路径修改后可能需要重启ComfyUI才能生效
- 确保自定义路径有足够的写入权限
- 手动放置模型文件时要注意保持正确的目录结构
最佳实践建议
对于大多数用户，推荐组合使用方法一和方法二：
- 首先启用系统的长路径支持
- 然后配置较短的模型存储路径
- 这样可以同时解决当前问题和预防未来可能出现的类似问题
对于无法修改系统设置的环境，手动下载模型文件是最可靠的解决方案。这种方法虽然需要用户自行管理模型文件，但完全避开了路径长度限制问题。
【免费下载链接】comfyui_controlnet_aux 项目地址: https://gitcode.com/gh_mirrors/co/comfyui_controlnet_aux
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
