高频错误
Bootstrapper 缺失(watchdog_bootstrapper_missing)
启动时提示"无法找到 ModelFinder.Bootstrapper.exe"的解决方法。
症状
启动 ComfyLauncher 时弹出错误窗口,提示"无法找到 ModelFinder.Bootstrapper.exe",ComfyUI 无法正常启动。
根本原因
ComfyLauncher 使用 ModelFinder.Bootstrapper.exe 作为辅助进程来启动和管理 ComfyUI。该文件位于安装目录(默认路径 %LocalAppData%\ModelFinder)下,与 ModelFinder.exe 同级。
绝大多数情况下,该文件丢失是因为被杀毒软件误删或隔离。 因为 bootstrapper 是一个非签名的小型可执行文件,杀毒软件的启发式检测容易将其标记为"可疑程序"并自动移入隔离区。以下三款杀毒软件最为常见:
- Windows Defender(Windows 自带)
- 360 安全卫士
- 火绒安全
严重程度
高 — 缺少 bootstrapper 将导致 ComfyUI 完全无法启动。
解决方法
第一步:确认文件是否存在
打开安装目录,检查 ModelFinder.Bootstrapper.exe 是否存在。默认安装路径为:
%LocalAppData%\ModelFinder
在文件资源管理器的地址栏直接粘贴上面的路径即可跳转。如果文件不存在,说明已被杀毒软件删除或隔离,继续执行下面的步骤。
第二步:从杀毒软件恢复文件并加白名单
根据你使用的杀毒软件,选择对应的操作指南。
Windows Defender
查看隔离记录(GUI 方式)
- 打开"Windows 安全中心"(在开始菜单搜索"Windows 安全")
- 点击"病毒和威胁防护"
- 点击"保护历史记录"
- 在列表中查找与
ModelFinder相关的条目 - 如果找到,点击该条目,选择"操作" -> "还原"
查看隔离记录(PowerShell 方式)
以管理员身份打开 PowerShell,执行以下命令查看最近的威胁检测记录:
Get-MpThreatDetection | Select-Object -First 20 | Format-List DetectionID, ActionSuccess, Resources
也可以使用 Defender 命令行工具列出所有被隔离的文件:
& "$env:ProgramFiles\Windows Defender\MpCmdRun.exe" -Restore -ListAll
添加排除目录
GUI 方式:
- 打开"Windows 安全中心" -> "病毒和威胁防护"
- 在"病毒和威胁防护设置"下,点击"管理设置"
- 向下滚动到"排除项",点击"添加或删除排除项"
- 点击"添加排除项" -> "文件夹"
- 选择 ComfyLauncher 的安装目录(默认
%LocalAppData%\ModelFinder)
PowerShell 方式(需要管理员权限):
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\ModelFinder"
执行后可以验证排除项是否已生效:
Get-MpPreference | Select-Object -ExpandProperty ExclusionPath
360 安全卫士
恢复隔离文件
- 打开 360 安全卫士主界面
- 点击"木马查杀"(或"安全防护中心")
- 查看"隔离区"或"恢复区"
- 找到与
ModelFinder相关的文件,勾选后点击"恢复"
添加信任目录
- 打开 360 安全卫士主界面
- 点击顶部的安全防护图标(小盾牌/小十字图标),进入"安全操作中心"
- 切换到"已信任区"标签页
- 点击"添加目录"
- 选择 ComfyLauncher 安装目录(默认
%LocalAppData%\ModelFinder) - 在弹出的确认窗口中点击"确定"
如果使用的是 360 安全卫士极速版,操作路径可能略有不同,但信任区功能位置相似。
火绒安全
恢复隔离文件
- 打开火绒安全主界面
- 点击左侧的"安全日志"
- 找到被拦截的
ModelFinder.Bootstrapper.exe记录 - 点击"恢复"将文件还原
添加信任目录
- 打开火绒安全主界面
- 点击右上角的菜单按钮(三条横线图标)
- 在弹出的菜单中点击"信任区"
- 点击"添加文件夹"
- 选择 ComfyLauncher 安装目录(默认
%LocalAppData%\ModelFinder) - 确认添加
第三步:重新安装 ComfyLauncher
如果在隔离区中找不到被删除的文件,需要重新安装来恢复缺失文件:
- 先完成上面的白名单设置,否则重新安装后文件会再次被删除
- 从官方渠道下载最新版 ComfyLauncher
- 安装到原来的目录
重新安装不会影响你已经部署的 ComfyUI 环境和已下载的模型。
安装完成后启动 ComfyLauncher,确认不再出现 bootstrapper 缺失错误。
仍然无法解决?
如果按照以上步骤操作后问题仍然存在,请通过应用内的"联系我们"按钮联系技术支持,并提供以下信息:
- 使用的杀毒软件名称和版本
- 安装目录的完整路径
- 隔离区中是否有 ModelFinder 相关记录
Wonderful Launcher 文档