启动失败是最高频的问题，按「现象 → 原因 → 解决」排查。
现象一：端口被占用
- 现象：启动后长时间停在 loading，日志提示端口被占用；
- 原因：其他程序 / 残留的 ComfyUI 实例占用了 8188 端口；
- 解决：
- 在「环境配置」修改端口（如 8189）后重启；
- 或结束占用进程后重启（
netstat -ano | findstr 8188可查 PID）。
现象二：DLL 缺失报错
- 现象：启动报
DLL load failed while importing _ctypes/_sqlite3等； - 原因：安装包不完整 / 旧版本残留 / 依赖被精简；
- 解决：卸载后重新下载完整安装包安装；仍不行则换文件夹版 / 单文件版。
现象三：依赖环境错误
- 现象：启动报缺少模块（ModuleNotFoundError）；
- 原因：便携环境损坏 / Python 路径指向了错误环境；
- 解决：在「环境配置」确认 Python 路径；重装软件恢复内置环境。
现象四：一直停在 loading 页
- 现象：画布一直显示 STARTING；
- 原因：服务未就绪（TCP 可连 ≠ HTTP 可用），或冷启动较慢；
- 解决：等待自动就绪；超过 2 分钟看控制台日志；必要时重启软件。
排查口诀：先看「控制台日志」再动手；日志导出后反馈可大幅加快解决。