[GH-ISSUE #1495] [Bug]: 安装comfyui桌面端后,无法启动 #440

New issue

Closed

opened 2026-10-31 22:13:01 +00:00 by bsakaguchi · 10 comments

bsakaguchi commented 2026-10-31 22:13:01 +00:00

Owner

Copy link

Originally created by @DevSissi on GitHub (Dec 23, 2025).
Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1495

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

Originally created by @DevSissi on GitHub (Dec 23, 2025). Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1495 ### App Version 0.6.1 ### Expected Behavior 正常打开应用 ### Actual Behavior <img width="1010" height="761" alt="Image" src="https://github.com/user-attachments/assets/f663a766-fe08-43df-b708-75411723c9e8" /> ### Steps to Reproduce 安装过程出现问题 ### Debug Logs ```powershell ``` ### Browser Logs _No response_ ### Settings JSON _No response_ ### Other [comfyui.log_2025-12-23T04-44-35-993Z.log](https://github.com/user-attachments/files/24303873/comfyui.log_2025-12-23T04-44-35-993Z.log) [main.log_2025-12-23T04-44-35-084Z.log](https://github.com/user-attachments/files/24303872/main.log_2025-12-23T04-44-35-084Z.log) [main.log](https://github.com/user-attachments/files/24303871/main.log) [comfyui.log](https://github.com/user-attachments/files/24303870/comfyui.log) ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1495-Bug-comfyui-2d26d73d365081a485f0f637c1b0e814) by [Unito](https://www.unito.io)

bsakaguchi 2026-10-31 22:13:01 +00:00

• closed this issue
• added the
  bug
  Potential Bug
  labels

bsakaguchi commented 2026-10-31 22:13:02 +00:00

Author

Owner

Copy link

@dosubot[bot] commented on GitHub (Dec 23, 2025):

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.

---

Docs are dead. Just use Dosu.

<!-- gh-comment-id:3685092413 --> @dosubot[bot] commented on GitHub (Dec 23, 2025): <!-- Greeting --> Hi @DevSissi! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the desktop team. <!-- Answer --> ComfyUI 桌面端无法启动（Python 进程退出 code 1）通常是安装过程中 Python 环境或依赖没有正确配置，常见原因包括网络问题、依赖下载失败、权限或杀毒软件干扰、虚拟环境损坏、自定义节点冲突等。可以按以下步骤排查和修复： 1. **重置虚拟环境**：关闭 ComfyUI，删除安装目录下的 `.venv` 文件夹，然后重新启动桌面端，让它自动重新创建环境并安装依赖。[参考](https://github.com/Comfy-Org/desktop/issues/1356) 2. **检查网络和镜像设置**：如果你在中国大陆或网络受限地区，安装时建议选择国内镜像（如 [python-standalone.org](https://python-standalone.org/mirror/astral-sh/python-build-standalone)、[阿里云 PyPI](https://mirrors.aliyun.com/pypi/simple/)），否则依赖下载可能失败。[参考](https://github.com/Comfy-Org/desktop/issues/1345) 3. **手动安装依赖**：如果 `.venv` 已存在但依赖不全，可以用桌面端自带终端，激活虚拟环境后执行 `pip install -r requirements.txt`，必要时加 `-i https://pypi.tuna.tsinghua.edu.cn/simple`。[参考](https://github.com/Comfy-Org/desktop/issues/1356) 4. **禁用自定义节点**：临时移走 `custom_nodes` 文件夹下所有自定义节点，排除第三方节点或依赖冲突导致启动失败。[参考](https://github.com/Comfy-Org/desktop/issues/1356) 5. **检查权限和杀毒软件**：确保安装目录和用户目录有读写权限，关闭杀毒软件或防护软件，避免文件锁定或权限拒绝。[参考](https://github.com/Comfy-Org/desktop/issues/1224) 6. **检查日志**：打开 `main.log` 和 `comfyui.log`，重点查找“missing package”、“network error”、“permission denied”等关键报错行，有助于定位问题。[参考](https://github.com/Comfy-Org/desktop/issues/1393) 7. **Manager 依赖问题**：v0.6.1 之后 Manager 依赖安装逻辑有更新，缺少 `manager_requirements.txt` 也会导致启动失败，日志如有相关报错需补全依赖。[参考](https://github.com/Comfy-Org/desktop/pull/1450) 8. **彻底重装**：如以上方法无效，建议删除安装目录和 `%APPDATA%\ComfyUI` 配置目录，重新在空文件夹安装桌面端，确保没有其他实例在运行。[参考](https://github.com/Comfy-Org/desktop/issues/836) 如遇特殊报错（如 `sqlite3.OperationalError`、`No pyvenv.cfg file`），请优先检查目录权限和环境完整性。 如果有关键日志内容，可以粘贴出来进一步定位。 <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=reply-with-mention&utm_term=Comfy-Org%2Fdesktop).* --- Docs are dead. Just use [Dosu](https://dosu.dev?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-tagline&utm_term=Comfy-Org%2Fdesktop). [](https://app.dosu.dev/response-feedback?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-feedback&utm_term=Comfy-Org%2Fdesktop#message_id=c0007a23-5293-4408-8377-06dcf831cf6d) [](https://github.dosu.com/Comfy-Org/desktop?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-ask-repo&utm_term=Comfy-Org%2Fdesktop) [](https://app.dosu.dev/signup?referrer=openSource&source=github-footer&utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-share-team&utm_term=Comfy-Org%2Fdesktop)

bsakaguchi commented 2026-10-31 22:13:02 +00:00

Author

Owner

Copy link

@DevSissi commented on GitHub (Dec 23, 2025):

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'

<!-- gh-comment-id:3685099903 --> @DevSissi commented on GitHub (Dec 23, 2025): 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'

bsakaguchi commented 2026-10-31 22:13:02 +00:00

Author

Owner

Copy link

@dosubot[bot] commented on GitHub (Dec 23, 2025):

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.

---

Share context across your team and agents. Try Dosu.

<!-- gh-comment-id:3685104467 --> @dosubot[bot] commented on GitHub (Dec 23, 2025): <!-- Answer --> ComfyUI 桌面版不会在安装目录下生成 requirements.txt，这是设计如此，依赖管理是由桌面端自动完成的。如果你需要手动修复依赖，请在虚拟环境中运行： ```powershell pip install -r resources/ComfyUI/requirements.txt ``` 如果 `resources/ComfyUI/requirements.txt` 也不存在，说明安装可能损坏，建议彻底卸载后重新安装桌面端，确保安装目录和 `%APPDATA%\ComfyUI` 都被清空（不要把用户数据放在安装目录，否则更新时会被删除）[参考](https://github.com/Comfy-Org/desktop/issues/1346)。 如依然无法启动，可关闭应用，删除 `.venv` 文件夹后重启桌面端，触发自动环境修复。如果有关键日志报错（如“missing package”、“permission denied”），可以粘贴出来进一步定位。 <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=reply-with-mention&utm_term=Comfy-Org%2Fdesktop).* --- Share context across your team and agents. Try [Dosu](https://dosu.dev?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-tagline&utm_term=Comfy-Org%2Fdesktop). [](https://app.dosu.dev/response-feedback?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-feedback&utm_term=Comfy-Org%2Fdesktop#message_id=685f7698-6916-4e09-bd25-8e226bf0caea) [](https://github.dosu.com/Comfy-Org/desktop?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-learn-repo&utm_term=Comfy-Org%2Fdesktop) [](https://app.dosu.dev/signup?referrer=openSource&source=github-footer&utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-add-team&utm_term=Comfy-Org%2Fdesktop)

bsakaguchi commented 2026-10-31 22:13:02 +00:00

Author

Owner

Copy link

@DevSissi commented on GitHub (Dec 23, 2025):

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

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

bsakaguchi commented 2026-10-31 22:13:02 +00:00

Author

Owner

Copy link

@dosubot[bot] commented on GitHub (Dec 23, 2025):

你的问题很可能是因为 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.

---

Docs are dead. Just use Dosu.

<!-- gh-comment-id:3685135029 --> @dosubot[bot] commented on GitHub (Dec 23, 2025): <!-- Answer --> 你的问题很可能是因为 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` 这些目录包含了桌面端的所有配置、缓存、数据库和日志，必须全部清空才能真正“重装”环境。[参考](https://docs.comfy.org/zh-CN/installation/desktop/windows) 2. **确保安装目录为全新空文件夹** 安装 ComfyUI Desktop 时，选择一个全新、空的文件夹作为安装目录，且不要把 ComfyUI 的 app 和模型/工作流等用户文件放在同一个目录。[参考](https://docs.comfy.org/zh-CN/installation/desktop/windows) 3. **首次启动后不要导入任何自定义节点或工作流** 先确认纯净环境下能否正常启动。如果能启动，再逐步恢复自定义节点和工作流，遇到问题时优先排查 custom_nodes 目录下的内容。 4. **如遇依赖缺失或节点报错** 进入 `.venv` 虚拟环境，分别在每个 custom_node 目录下执行 `pip install -r requirements.txt`，补全缺失依赖。[参考](https://github.com/Comfy-Org/desktop/issues/1356#issuecomment-3368038766) 5. **如仍无法启动** 检查 `%APPDATA%\ComfyUI\logs` 下的 `main.log` 和 `comfyui.log`，重点查找 “missing package”、“permission denied”、“sqlite3.OperationalError” 等关键报错。 如果有 workflow 自动加载，尝试先移走或重命名 workflow 文件，排除工作流损坏导致的卡死。[参考](https://github.com/Comfy-Org/desktop/issues/1393#issuecomment-3471093406) 6. **其他建议** - 禁用所有 custom_nodes 后逐步排查（可先全部移走 custom_nodes 目录内容，确认能否启动）。 - 检查 config.json、extra_model_config.yaml 等配置文件是否损坏，可先备份后删除，让桌面端自动重建。 - 如有杀毒软件或安全管控，建议临时关闭，避免文件被锁定或权限受限。 只要彻底清理 AppData 相关目录，99% 的“重装无效”问题都能解决。如果还有报错，可贴出最新的 main.log 和 comfyui.log 关键报错行，便于进一步定位。 <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=reply-with-mention&utm_term=Comfy-Org%2Fdesktop).* --- Docs are dead. Just use [Dosu](https://dosu.dev?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-tagline&utm_term=Comfy-Org%2Fdesktop). [](https://app.dosu.dev/response-feedback?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-feedback&utm_term=Comfy-Org%2Fdesktop#message_id=99676414-a2bc-4b3a-902e-eb5b7c6f8327) [](https://github.dosu.com/Comfy-Org/desktop?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-ask-repo&utm_term=Comfy-Org%2Fdesktop) [](https://app.dosu.dev/signup?referrer=openSource&source=github-footer&utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-share-team&utm_term=Comfy-Org%2Fdesktop)

bsakaguchi commented 2026-10-31 22:13:02 +00:00

Author

Owner

Copy link

@DevSissi commented on GitHub (Dec 23, 2025):

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

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

<!-- gh-comment-id:3685302268 --> @DevSissi commented on GitHub (Dec 23, 2025): 已尝试所有建议,重新安装后仍出现相同错误. <img width="489" height="371" alt="Image" src="https://github.com/user-attachments/assets/0cffb212-0efd-4656-a182-7f3e3f4c4673" /> [main.log](https://github.com/user-attachments/files/24304922/main.log) [main.log_2025-12-23T05-48-06-734Z.log](https://github.com/user-attachments/files/24304923/main.log_2025-12-23T05-48-06-734Z.log) [comfyui.log](https://github.com/user-attachments/files/24304924/comfyui.log)

bsakaguchi commented 2026-10-31 22:13:03 +00:00

Author

Owner

Copy link

@dosubot[bot] commented on GitHub (Dec 23, 2025):

你已经排查了常规所有路径，依然遇到 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.

---

Share context across your team and agents. Try Dosu.

<!-- gh-comment-id:3685325168 --> @dosubot[bot] commented on GitHub (Dec 23, 2025): <!-- Answer --> 你已经排查了常规所有路径，依然遇到 Python 进程 code 1 启动失败，这种极端顽固的情况，结合社区类似案例和官方文档，建议重点排查以下高级原因： 1. **虚拟环境未能正确创建或损坏**：.venv 文件夹如果因权限、路径（如安装在 OneDrive、同步盘、系统保护目录）、网络（Python build 下载失败）、杀毒软件等原因未能完整创建，会导致 code 1 启动失败。建议彻底删除 .venv 后，确保安装路径为本地磁盘根目录下的全新空文件夹（如 D:\ComfyUI），关闭杀毒软件并以管理员身份运行安装包，重装一次。[参考](https://github.com/Comfy-Org/desktop/issues/1477) 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 ``` [参考](https://github.com/Comfy-Org/desktop/issues/1477) 3. **配置文件或缓存损坏**：%APPDATA%\ComfyUI 下的 config.json、extra_model_config.yaml、数据库文件损坏会导致反复启动失败。建议备份后全部删除，让桌面端自动重建。[参考](https://github.com/Comfy-Org/desktop/issues/1493) 4. **系统环境或硬件冲突**：如内存不足、驱动过旧、Python 路径冲突、系统变量污染等。建议升级显卡驱动，检查系统内存，确保无其他 Python 进程残留，必要时重启电脑。[参考](https://github.com/Comfy-Org/desktop/issues/1346) 5. **彻底排除 custom_nodes/workflow 问题**：custom_nodes 目录务必全空，%APPDATA%\ComfyUI\workflows 下如有自动加载的 workflow 也建议全部移走，排除残留损坏数据影响。[参考](https://github.com/Comfy-Org/desktop/issues/1393) 6. **尝试 Portable/手动安装版**：如桌面端始终无法启动，可尝试 [Portable 版](https://docs.comfy.org/installation/comfyui_portable_windows) 或 [手动安装](https://docs.comfy.org/installation/manual_install) 方式，绕过桌面端的环境自动管理，直接用官方 Python 环境运行 ComfyUI。[参考](https://github.com/Comfy-Org/desktop/issues/1346) 7. **换一台电脑/系统测试**：极少数情况下，系统底层环境或硬件兼容性问题会导致所有方法无效。可尝试在另一台电脑或全新系统环境下安装验证。[参考](https://github.com/Comfy-Org/desktop/issues/1434) 如仍无法解决，建议重点关注 main.log 和 comfyui.log 是否有 “missing package”、“permission denied”、“sqlite3.OperationalError” 等关键报错行，或贴出最新报错片段便于进一步定位。[官方高级排查文档](https://docs.comfy.org/troubleshooting/overview) 可参考。 <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=reply-with-mention&utm_term=Comfy-Org%2Fdesktop).* --- Share context across your team and agents. Try [Dosu](https://dosu.dev?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-tagline&utm_term=Comfy-Org%2Fdesktop). [](https://app.dosu.dev/response-feedback?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-feedback&utm_term=Comfy-Org%2Fdesktop#message_id=5c92049b-2986-4bd8-9b33-92c0aa09cdc4) [](https://github.dosu.com/Comfy-Org/desktop?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-learn-repo&utm_term=Comfy-Org%2Fdesktop) [](https://app.dosu.dev/signup?referrer=openSource&source=github-footer&utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=knowledge-infrastructure-add-team&utm_term=Comfy-Org%2Fdesktop)

bsakaguchi commented 2026-10-31 22:13:03 +00:00

Author

Owner

Copy link

@DevSissi commented on GitHub (Dec 23, 2025):

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

<!-- gh-comment-id:3685414230 --> @DevSissi commented on GitHub (Dec 23, 2025): 似乎只能使用portable版本了,我试了便携版是没有问题的,可以在网页正常使用. 便携版没有桌面端的节点和模型快速下载功能啊

bsakaguchi commented 2026-10-31 22:13:03 +00:00

Author

Owner

Copy link

@DevSissi commented on GitHub (Dec 24, 2025):

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

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

bsakaguchi commented 2026-10-31 22:13:03 +00:00

Author

Owner

Copy link

@dosubot[bot] commented on GitHub (Mar 25, 2026):

Hi, @DevSissi. I'm Dosu, and I'm helping the desktop team manage their backlog and am marking this issue as stale.

Issue Summary:

• You reported that ComfyUI desktop version 0.6.1 fails to start despite multiple reinstall attempts and clearing files.
• The likely cause is incomplete cleanup of configuration/cache files or corrupted custom nodes/dependencies.
• I recommended fully uninstalling, manually deleting AppData folders, reinstalling cleanly, avoiding custom nodes initially, and checking logs for errors.
• You confirmed trying some of these steps but the startup failure persists.
• No resolution has been reached yet.

Next Steps:

• Please let me know if this issue is still relevant with the latest version of ComfyUI by commenting here to keep the discussion open.
• Otherwise, this issue will be automatically closed in 7 days.

Thank you for your understanding and contribution!

<!-- gh-comment-id:4127827236 --> @dosubot[bot] commented on GitHub (Mar 25, 2026): Hi, @DevSissi. I'm [Dosu](https://dosu.dev), and I'm helping the desktop team manage their backlog and am marking this issue as stale. **Issue Summary:** - You reported that ComfyUI desktop version 0.6.1 fails to start despite multiple reinstall attempts and clearing files. - The likely cause is incomplete cleanup of configuration/cache files or corrupted custom nodes/dependencies. - I recommended fully uninstalling, manually deleting AppData folders, reinstalling cleanly, avoiding custom nodes initially, and checking logs for errors. - You confirmed trying some of these steps but the startup failure persists. - No resolution has been reached yet. **Next Steps:** - Please let me know if this issue is still relevant with the latest version of ComfyUI by commenting here to keep the discussion open. - Otherwise, this issue will be automatically closed in 7 days. Thank you for your understanding and contribution!

bsakaguchi referenced this issue 2026-10-31 22:17:36 +00:00

[PR #440] [MERGED] Revert "Settings store" #868

bsakaguchi referenced this issue 2026-10-31 22:17:39 +00:00

[PR #446] [MERGED] Reland #362 - improved startup error handling #873

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

chore/archive-notice

deepme987/desktop/deprecation-banner

bl/bump-comfyui-0-22-3

add-comfy-environment-marker

bl/missing-model-download-contract

bl/bump-comfyui-0.20.2

sno-proxysettings

bl/missing-model-download-ui-consume-fix

bl/missing-model-download-ui-test

feat/deep-link-protocol-handler

ben/oem-machine-scope-install-state

bl/fix-missing-model-download-path-e2e

bump-workflow-templates

chore/example-pr-close

chore/bump-frontend-1.39.19-r2

fix/frontend-optional-branch-core-1-39

fwra

chore/frontend-override-backport-9185-core-1.39

bump-comfyui-v0.15.0-package-json-only

ben/auto-bump-comfyui-release-optional-main-commit

bump-uv-v0.10.4-and-macos-resolution

ben/auto-bump-comfyui-release

fix/sentry-gpu-driver-reporting

fix/close-confirmation-ipc

fix/desktop-frontend-sourcemaps

revert-1565-chore/pytorch-2-10

chore/deps-rollup-2026-01-29

fix/macos-torch-index

fix/disable-forced-pytorch-upgrade

fix/rename-upgrade-packages-to-needs-package-update

fix/venv-troubleshooting-e2e

update-comfyui-core-0.9.2

torch-update-prompt

issue-1534-nvidia-driver-warning

revert-core-comfyui-0-9-1

bl-canary-release

bl-flaky-version-mask

chore/pytorch-2.9.1-cu130

bl-fix-amd-aarch-warning

bl-shaggy-urial

fix-todesktop-workflow

fix/self-heal-missing-dirs

bl-aggregate-ape

bl-interesting-warbler

bl-dramatic-opossum

bl-northern-whippet

bl-update-deps

copilot/fix-1228

build-head-20251001

custom-dialog

parse-uv-v

api-clean-up

parse-uv

release-action

uninstaller-options

full-installer

bundle-git-installer

vcpp-installer

uninstall-cleanup

update-bump-stable-command

frontend-optional-branch-v3-interface-menu

system-pop-up

feat-custom-launch

publish/private

macos-install-path

0.4.40

model_file_import

rh-fix3

robinjhuang-patch-1

rh-manager2

remove-redundant-ci

e2e-bad-start

version-bump-2025-02-20-1740010810152

test/beforeunload-confirm

e2e2-2

debug-log-events

rh-nodes

cb-store

clean-comfy-server

lumina-release

release-2025-feb06

rh-tsx

fix_setting_ids

use_npm

default-no-reload-page

first-time-user-setting

window-style-change

readme-dev-linux

virtual-validation-testing

app-state

enh/Add-Check-For-Updates-button

git-installer

enh/Save-user-preference-for-crashes-after-confirmation-dialog

enh/include-vcredist

error-handling

dev-ken

dev-kendal-todesktop-securit

dev-kendal-startup-test

dev-squirrel-uninstall

dev-kendal

v0.9.4

v0.9.3

v0.9.2

v0.9.1

v0.9.0

v0.8.36

v0.8.35

v0.8.34

v0.8.33

v0.8.32

v0.8.31

v0.8.30

v0.8.29

v0.8.28

v0.8.27

v0.8.26

v0.8.25

v0.8.24

v0.8.23

v0.8.22

v0.8.21

v0.8.20

v0.8.19

v0.8.18

v0.8.16

v0.8.15

v0.8.14

v0.8.13

v0.8.12

v0.8.11

v0.8.10

v0.8.9

v0.8.8

v0.8.7

v0.8.6

v0.8.5

v0.8.4

v0.8.3

v0.8.2

v0.8.1

v0.8.0

v0.7.5

v0.7.4

v0.7.3

v0.7.2

v0.7.1

v0.7.0

v0.6.2

v0.6.1

v0.6.0

v0.5.12

v0.5.11

v0.5.10

v0.5.9

v0.5.8

v0.5.7

v0.5.6

v0.5.5

v0.5.4

v0.5.3

v0.5.2

v0.5.1

v0.5.0

v0.4.76

v0.4.75

v0.4.74

v0.4.73

v0.4.72

v0.4.71

v0.4.70

v0.4.69

v0.4.68

v0.4.67

v0.4.66

v0.4.65

v0.4.64

v0.4.63

v0.4.62

v0.4.61

v0.4.60

v0.4.59

v0.4.58

v0.4.57

v0.4.56

v0.4.55

v0.4.54

v0.4.53

v0.4.52

v0.4.51

v0.4.50

v0.4.49

v0.4.48

v0.4.47

v0.4.46

v0.4.45

v0.4.44

v0.4.41

v0.4.40

v0.4.39

v0.4.36

v0.4.35

v0.4.34

v0.4.33

v0.4.32

v0.4.30

v0.4.29

v0.4.28

v0.4.27

v0.4.26

v0.4.25

v0.4.24

v0.4.23

v0.4.22

v0.4.21

v0.4.20

v0.4.19

v0.4.18

v0.4.17

v0.4.16

v0.4.13

v0.4.12

v0.4.7

v0.4.6

v0.4.5

v0.4.4

v0.4.3

v0.3.18

v0.4.2

Labels

Clear labels   

area: desktop-app

  

Bounty

  

bug

  

bug-cop:answered

  

bug-cop:response-received

  

component: installer

  

component: preload

  

custom node

  

dependencies

  

Design

  

documentation

  

duplicate

  

enhancement

  

expected

  

frontend

  

good first issue

  

installation

  

Low-Priority

  

performance

  

Planned

  

platform: cross-platform

  

platform: windows

  

Potential Bug

  

Potential Bug

  

pull-request

Mirrored from GitHub Pull Request

  

question

  

refactor

  

Release

  

stale

  

User Support

  

V1

No labels

area: desktop-app

Bounty

bug

bug-cop:answered

bug-cop:response-received

component: installer

component: preload

custom node

dependencies

Design

documentation

duplicate

enhancement

expected

frontend

good first issue

installation

Low-Priority

performance

Planned

platform: cross-platform

platform: windows

Potential Bug

Potential Bug

pull-request

question

refactor

Release

stale

User Support

V1

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Comfy-Org/desktop#440

No description provided.