html
ComfyUI 启动时控制台仅闪现数行日志即退出，或 python main.py 执行后无任何 HTTP 服务监听提示（如 Starting server...），属典型“静默失败”。此阶段不报错 ≠ 无错误，往往因异常被未捕获而提前终止。
- 务必添加
--verbose参数：python main.py --verbose --listen - 重点关注首条
ERROR行及其上方最近的Traceback (most recent call last): - 常见日志陷阱：
ModuleNotFoundError: No module named 'torch'（依赖缺失）、JSONDecodeError: Expecting property name enclosed in double quotes（config.json 语法错误）
torch 编译失败）
python --versionPyTorchCUDA 12.1 + torch 2.3.x（Windows/Linux）；MPS 支持需 torch 2.2+（macOS）
python -c "import torch; print(torch.__version__, torch.cuda.is_available())"
xformers 是性能关键但安装最易出错的组件：Windows 用户常因 MSVC 工具链缺失导致 pip install xformers 编译失败；推荐使用预编译 wheel：
pip install -U -i https://pypi.tuna.tsinghua.edu.cn/simple/ xformers --extra-index-url https://download.pytorch.org/whl/cu121
comfy-cli 若版本过旧（<0.4.0），其 comfy install 命令可能跳过 custom_nodes 依赖校验——建议始终手动执行 pip list | grep -E "(torch|xformers|comfy)" 交叉核对。
kill -9 PID] B -->|是| D{当前目录是否为ComfyUI根？} D -->|否| E[cd 到含main.py的目录再执行] D -->|是| F{路径含中文/空格？} F -->|是| G[重命名路径为纯ASCII+下划线]
- nvidia-smi 显示驱动版本 ≥ CUDA 运行时版本（例：驱动 535.129.03 → 支持 CUDA 12.2）
- 运行
nvcc --version确认 toolkit 版本，必须与 PyTorch wheel 标注的 CUDA 版本一致 - 启用
--gpu-only时，若torch.cuda.device_count() == 0，将直接 abort —— 此时需检查 NVIDIA Container Toolkit（Docker 场景）或禁用集成显卡 BIOS 设置
config.json 中单个逗号缺失、单引号替代双引号、尾部多余逗号，均会导致 json.load() 抛出 JSONDecodeError 并中断初始化；更隐蔽的是自定义节点的 __init__.py 中存在未处理的 ImportError（如依赖某未安装的 PIL 插件），该异常在 ComfyUI 的 load_custom_node() 中被静默吞掉——解决方案：临时重命名 custom_nodes 目录，逐个恢复排查。
Windows：即使以管理员身份运行 CMD，若启用了 UAC 且未勾选“以管理员身份运行”，仍无法绑定 1024 以下端口（虽 8188 不在此列，但防火墙规则可能拦截）；Linux：若 ComfyUI 安装在 /opt/comfyui，普通用户无写权限会导致 models/checkpoints 缓存失败；macOS：SIP 保护下，/usr/local 下的 Python 环境可能拒绝加载非签名 wheel —— 推荐使用 pyenv 或 conda 隔离环境。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/265728.html