知仓学习社知仓学习社
ComfyUI Desktop 桌面版装完打不开：白屏或一直转圈 / 全站资源搜索
搜索 更新 2026-10-02
报错 086 前端界面、浏览器与工作流加载 有来源可查

ComfyUI Desktop 桌面版装完打不开：白屏或一直转圈

报错原文（原样） 
** ComfyUI startup time: 2025-01-02 16:33:18.648639
** Platform: Windows
** Python version: 3.12.8 (main, Dec  6 2024, 18:10:20) [MSC v.1942 64 bit(AMD64)]
** Python executable: D:\ComfyUI_Desktop\.venv\Scripts\python.exe
** ComfyUI Path: C:\Users\loveu\AppData\Local\Programs\@comfyorgcomfyui-electron\resources\ComfyUI
** Log path: D:\ComfyUI_Desktop\comfyui.log
Prestartup times for custom nodes:
[2025-01-02 16:33:20.943]    4.8 seconds: C:\Users\loveu\AppData\Local\Programs\@comfyorgcomfyui-electron\resources\ComfyUI\custom_nodes\ComfyUI-Manager
检索关键词 ComfyUI Desktop、spinning state、Unable to start、comfyui.log、Log path、desktop 白屏、桌面版 转圈
先看这一句 ComfyUI Desktop 安装完成后启动界面一直转圈、白屏或停在下不了载的维护页面，反复重装也一样；便携版命令行启动却是好的。
适用版本 全版本通用（桌面版专属） · 核实日期 2026-09-26 · 状态 已核实
适用环境：ComfyUI Desktop

现象与触发场景

常见触发场景：

  • 安装后首次启动，依赖还在装或装失败
  • 桌面版内置的 ComfyUI 与自定义节点版本不兼容
  • 设置里的监听地址/端口被改过，Electron 壳连不上后端
  • 输出或模型存储位置指向了不可写路径

根因

  • 启动期就被某个自定义节点拖住。ComfyUI-Org/desktop#587 的日志原文里明确出现 "Prestartup times for custom nodes:" 并列出 ComfyUI-Manager 占用 4.8 秒，说明桌面版启动会逐个加载自定义节点，任何一个卡住都会让界面停在转圈状态；同 issue 中报告者最后的结论是「只安装与原来 ComfyUI 不兼容的内容之外的东西，就能正常启动」
  • 官方文档把桌面版启动失败归到一组明确原因上：系统要求不满足、安装失败（需管理员权限运行、至少 15GB 磁盘空间）、维护页面下载失败（要检查镜像设置）、缺少模型（迁移只链接不复制，需核对模型路径）；Windows 版桌面版只支持带 CUDA 的 NVIDIA GPU，其他 GPU 应改用便携版或手动安装
  • 日志位置不明确导致无法自查。desktop#587 的日志原文直接给出了 ** Log path 字段与 ** ComfyUI Path 字段，这正是排查桌面版问题的第一手信息

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 先按日志路径把日志找出来
    桌面版的启动日志会打印 ** Log path（例如 D:\ComfyUI_Desktop\comfyui.log）与 ** ComfyUI Path（Electron 资源目录下的 ComfyUI）。按这两个字段去对应目录取日志，看最后几行是哪个自定义节点或哪一步卡住的。官方故障排查文档也建议在 macOS 上查看控制台应用里的崩溃报告，思路一致。
  2. 绕过 Electron 壳直接启动后端，判断是壳的问题还是后端的问题
    官方自定义节点排查文档给出了桌面版用户的做法：可以用设置菜单禁用全部自定义节点启动，或者手工起服务：cd 到 ComfyUI 目录后用桌面版自己的 python 执行 main.py --disable-all-custom-nodes。如果这样能起来，问题就在自定义节点上；如果还是起不来，就是后端环境本身有问题。
    cd path/to/your/comfyui
    python main.py --disable-all-custom-nodes
  3. 逐项核对桌面版的已知前置条件
    按官方故障排查文档逐项检查：Windows 桌面版仅支持带 CUDA 的 NVIDIA GPU；安装需以管理员权限运行且至少 15GB 磁盘空间；维护页面下载失败要检查镜像设置；迁移过来的模型只是被链接不会被复制，必须自行核对模型路径；缺少库要用包管理器补装依赖。
  4. 端口与监听地址不一致时改回默认
    桌面版与便携版默认端口不同（ComfyUI Wiki 记录便携版 8188、桌面版 8000），若在设置 → 服务器配置里改过监听地址或端口，而启动的实例用的是别的端口，壳就连不上后端而一直转圈。把监听地址改回 127.0.0.1、端口保持默认后重启验证；需要局域网访问再改成 0.0.0.0。

验证是否修好

桌面版能进入完整界面不再转圈，日志文件里不再出现卡住的自定义节点或依赖安装失败，并且能跑通一次默认工作流。

补充说明

desktop#587 的日志原文在采集时被截断，引用部分严格限于已取到的行（Prestartup times、Python 版本、Log path 等），未补写未取到的内容。桌面版的调试入口依据官方故障排查文档与 ComfyUI Wiki 的端口记录。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [204] （官方 issue）　[Unable to start] After installation, the startup remains in a spinnin　https://github.com/Comfy-Org/desktop/issues/587
  2. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues　https://docs.comfy.org/troubleshooting/overview
  3. [68] （官方文档）　Troubleshooting Custom Node Issues　https://docs.comfy.org/troubleshooting/custom-node-issues
  4. [199] （社区）　ComfyUI 端口 8188 和 8000：局域网访问与远程访问设置　https://comfyui-wiki.com/zh/faq/how-to-access-comfyui-on-lan

这条报错要用到的东西

按本条报错所属的类别（前端界面、浏览器与工作流加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
工作流换一条已知结构完整的工作流对照排查 板块

同一类别的其他条目

【078】打开 127.0.0.1:8188 只有空白页或一直转圈，界面加载不出来 有来源 【079】工作流所有节点变红、提示缺少节点或 Cannot find node，无法执行 有来源 【080】新版前端与旧工作流不兼容：旧工作流节点错位、widget 丢失或值变成 undefined 有来源 【081】浏览器控制台报 Failed to load resource: ERR_CONNECTION_REFUSED，页面打不开或功能全失效 有来源 【082】出图成功但看不到图：预览 404、保存的图片找不到 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库