[Bug]: 安装comfyui桌面端后,无法启动

[DevSissi]

App Version

0.6.1

Expected Behavior

正常打开应用

Actual Behavior

Steps to Reproduce

安装过程出现问题

Debug Logs

Browser Logs

No response

Settings JSON

No response

Other

comfyui.log_2025-12-23T04-44-35-993Z.log
main.log_2025-12-23T04-44-35-084Z.log
main.log
comfyui.log

┆Issue is synchronized with this Notion page by Unito

[dosubot]

Hi @DevSissi! I'm Dosu and I’m helping the desktop team.

ComfyUI 桌面端无法启动（Python 进程退出 code 1）通常是安装过程中 Python 环境或依赖没有正确配置，常见原因包括网络问题、依赖下载失败、权限或杀毒软件干扰、虚拟环境损坏、自定义节点冲突等。可以按以下步骤排查和修复：

1. 重置虚拟环境：关闭 ComfyUI，删除安装目录下的 .venv 文件夹，然后重新启动桌面端，让它自动重新创建环境并安装依赖。参考
2. 检查网络和镜像设置：如果你在中国大陆或网络受限地区，安装时建议选择国内镜像（如 python-standalone.org、阿里云 PyPI），否则依赖下载可能失败。参考
3. 手动安装依赖：如果 .venv 已存在但依赖不全，可以用桌面端自带终端，激活虚拟环境后执行 pip install -r requirements.txt，必要时加 -i https://pypi.tuna.tsinghua.edu.cn/simple。参考
4. 禁用自定义节点：临时移走 custom_nodes 文件夹下所有自定义节点，排除第三方节点或依赖冲突导致启动失败。参考
5. 检查权限和杀毒软件：确保安装目录和用户目录有读写权限，关闭杀毒软件或防护软件，避免文件锁定或权限拒绝。参考
6. 检查日志：打开 main.log 和 comfyui.log，重点查找“missing package”、“network error”、“permission denied”等关键报错行，有助于定位问题。参考
7. Manager 依赖问题：v0.6.1 之后 Manager 依赖安装逻辑有更新，缺少 manager_requirements.txt 也会导致启动失败，日志如有相关报错需补全依赖。参考
8. 彻底重装：如以上方法无效，建议删除安装目录和 %APPDATA%\ComfyUI 配置目录，重新在空文件夹安装桌面端，确保没有其他实例在运行。参考

如遇特殊报错（如 sqlite3.OperationalError、No pyvenv.cfg file），请优先检查目录权限和环境完整性。
如果有关键日志内容，可以粘贴出来进一步定位。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[DevSissi]

1,2均尝试过,没有效果.4的自定义节点文件夹为空.
尝试3的过程中提示:
(ComfyUI) D:\Engine\ComfyUI>pip install -r requirements.txt

[notice] A new release of pip is available: 25.1.1 -> 25.3
[notice] To update, run: D:\Dev\Python\Python313\python.exe -m pip install --upgrade pip
ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'

[dosubot]

ComfyUI 桌面版不会在安装目录下生成 requirements.txt，这是设计如此，依赖管理是由桌面端自动完成的。如果你需要手动修复依赖，请在虚拟环境中运行：

pip install -r resources/ComfyUI/requirements.txt

如果 resources/ComfyUI/requirements.txt 也不存在，说明安装可能损坏，建议彻底卸载后重新安装桌面端，确保安装目录和 %APPDATA%\ComfyUI 都被清空（不要把用户数据放在安装目录，否则更新时会被删除）参考。

如依然无法启动，可关闭应用，删除 .venv 文件夹后重启桌面端，触发自动环境修复。如果有关键日志报错（如“missing package”、“permission denied”），可以粘贴出来进一步定位。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[DevSissi]

当前comfyui的桌面app和文件不能安装在同一文件夹.
所以我使用了pip install -r D:comfyuidesktop/resources/ComfyUI/requirements.txt
安装全部完成后,仍无法打开.
当前的问题已经是数次重复安装后的重复问题.我将comfyui完全卸载,且通过everything删除了电脑上所有comfyui的文件.
但就算如此,重新安装也还是这个错误.我前面以及上传了log文件.
(起因是导入了一个自定义工作流,缺失节点,下载节点后卡住,强退后无法打开,重新安装后仍然是这个问题)

[dosubot]

你的问题很可能是因为 ComfyUI Desktop 的配置或缓存文件没有被完全清理，或者自定义节点/依赖损坏导致环境持续异常。即使用 Everything 删除了所有可见文件，Windows 下的隐藏 AppData 目录通常不会被检索到，里面的残留配置会导致反复重装也无法恢复正常启动。

建议按以下顺序彻底排查和修复：

1. 彻底卸载并清理所有相关目录
   卸载 ComfyUI Desktop 后，手动删除以下目录（这些目录 Everything 搜不到）：

   • C:\Users\<你的用户名>\AppData\Local\@comfyorgcomfyui-electron-updater
   • C:\Users\<你的用户名>\AppData\Local\Programs\@comfyorgcomfyui-electron
   • C:\Users\<你的用户名>\AppData\Roaming\ComfyUI
     这些目录包含了桌面端的所有配置、缓存、数据库和日志，必须全部清空才能真正“重装”环境。参考

2. 确保安装目录为全新空文件夹
   安装 ComfyUI Desktop 时，选择一个全新、空的文件夹作为安装目录，且不要把 ComfyUI 的 app 和模型/工作流等用户文件放在同一个目录。参考

3. 首次启动后不要导入任何自定义节点或工作流
   先确认纯净环境下能否正常启动。如果能启动，再逐步恢复自定义节点和工作流，遇到问题时优先排查 custom_nodes 目录下的内容。

4. 如遇依赖缺失或节点报错
   进入 .venv 虚拟环境，分别在每个 custom_node 目录下执行 pip install -r requirements.txt，补全缺失依赖。参考

5. 如仍无法启动
   检查 %APPDATA%\ComfyUI\logs 下的 main.log 和 comfyui.log，重点查找 “missing package”、“permission denied”、“sqlite3.OperationalError” 等关键报错。
   如果有 workflow 自动加载，尝试先移走或重命名 workflow 文件，排除工作流损坏导致的卡死。参考

6. 其他建议

   • 禁用所有 custom_nodes 后逐步排查（可先全部移走 custom_nodes 目录内容，确认能否启动）。
   • 检查 config.json、extra_model_config.yaml 等配置文件是否损坏，可先备份后删除，让桌面端自动重建。
   • 如有杀毒软件或安全管控，建议临时关闭，避免文件被锁定或权限受限。

只要彻底清理 AppData 相关目录，99% 的“重装无效”问题都能解决。如果还有报错，可贴出最新的 main.log 和 comfyui.log 关键报错行，便于进一步定位。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[DevSissi]

已尝试所有建议,重新安装后仍出现相同错误.

main.log
main.log_2025-12-23T05-48-06-734Z.log
comfyui.log

[dosubot]

你已经排查了常规所有路径，依然遇到 Python 进程 code 1 启动失败，这种极端顽固的情况，结合社区类似案例和官方文档，建议重点排查以下高级原因：

1. 虚拟环境未能正确创建或损坏：.venv 文件夹如果因权限、路径（如安装在 OneDrive、同步盘、系统保护目录）、网络（Python build 下载失败）、杀毒软件等原因未能完整创建，会导致 code 1 启动失败。建议彻底删除 .venv 后，确保安装路径为本地磁盘根目录下的全新空文件夹（如 D:\ComfyUI），关闭杀毒软件并以管理员身份运行安装包，重装一次。参考

2. 依赖未能完全安装：即使 requirements.txt 安装无报错，部分依赖（如 comfyui-frontend-package、PyTorch、ONNX Runtime）可能因网络或镜像问题未装全。建议进入 .venv 环境，手动执行：

   pip install -r resources/ComfyUI/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
   

   并检查有无报错。NVIDIA 显卡建议再执行：

   pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu128
   

   参考

3. 配置文件或缓存损坏：%APPDATA%\ComfyUI 下的 config.json、extra_model_config.yaml、数据库文件损坏会导致反复启动失败。建议备份后全部删除，让桌面端自动重建。参考

4. 系统环境或硬件冲突：如内存不足、驱动过旧、Python 路径冲突、系统变量污染等。建议升级显卡驱动，检查系统内存，确保无其他 Python 进程残留，必要时重启电脑。参考

5. 彻底排除 custom_nodes/workflow 问题：custom_nodes 目录务必全空，%APPDATA%\ComfyUI\workflows 下如有自动加载的 workflow 也建议全部移走，排除残留损坏数据影响。参考

6. 尝试 Portable/手动安装版：如桌面端始终无法启动，可尝试 Portable 版 或 手动安装 方式，绕过桌面端的环境自动管理，直接用官方 Python 环境运行 ComfyUI。参考

7. 换一台电脑/系统测试：极少数情况下，系统底层环境或硬件兼容性问题会导致所有方法无效。可尝试在另一台电脑或全新系统环境下安装验证。参考

如仍无法解决，建议重点关注 main.log 和 comfyui.log 是否有 “missing package”、“permission denied”、“sqlite3.OperationalError” 等关键报错行，或贴出最新报错片段便于进一步定位。官方高级排查文档 可参考。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[DevSissi]

似乎只能使用portable版本了,我试了便携版是没有问题的,可以在网页正常使用.
便携版没有桌面端的节点和模型快速下载功能啊

[DevSissi]

目前问题已经修复,软件默认下载cu129,当前cuda最新版本为13.1,所以cu130更好,不过cu129应该也可以.
主要原因是:
国内网络环境无法正常下载pytorch的大文件,而我使用的阿里云镜像无法拉取对应文件,只能手动下载whl文件后安装,重新打开软件即可.
其实log文件里面写的很清楚,无法找到对应版本的pytorch