知仓学习社知仓学习社
更新后启动失败：只 git pull 没更新依赖，或误用 update_comfyui_and_python_dependencies.bat / 全站资源搜索
搜索 更新 2026-10-02
报错 009 安装、启动与运行环境 有来源可查

更新后启动失败：只 git pull 没更新依赖，或误用 update_comfyui_and_python_dependencies.bat

报错原文（原样） 
Falling back to the default frontend.
ComfyUI frontend version: xxx
检索关键词 Falling back to the default frontend、git pull、pip install -r requirements.txt、update_comfyui_and_python_dependencies.bat、更新后打不开、依赖过期、comfyui-frontend-package
先看这一句 git pull / 更新脚本跑完后 ComfyUI 启动异常：前端界面缺失或显示异常、找不到新工作流模板、节点帮助文档过时，甚至直接起不来。
适用版本 全版本通用；官方更新文档为当前版本口径 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、ComfyUI Desktop、Linux + 云 GPU

现象与触发场景

常见触发场景：

  • 只执行 git pull 就开始用，没有同步核心依赖
  • 误跑了 update_comfyui_and_python_dependencies.bat
  • 中国大陆网络导致依赖包下载失败后被回退

根因

  • ComfyUI 的更新包含两部分：核心代码 + 核心依赖（comfyui-frontend-package、comfyui-workflow-templates、comfyui-embedded-docs 等）；只拉代码不更新依赖就会出现前端/模板/文档缺失
  • 官方更新文档把 update_comfyui_and_python_dependencies.bat 标为“⚠️ 危险：重装依赖”，会重装 PyTorch 与全部 Python 依赖，可能与现有配置冲突、破坏依赖特定包版本的自定义节点
  • 依赖更新失败（网络或权限）时官方会回退到旧前端，并在启动日志里打印 Falling back to the default frontend

解决步骤

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

  1. 更新代码后同步更新依赖
    官方标准流程是 git pull 之后必须执行 pip install -r requirements.txt；便携版则直接用 update 文件夹里的 update_comfyui.bat（它同时更新代码与依赖）。
    git pull
    pip install -r requirements.txt
  2. 便携版手动更新依赖的正确写法
    便携版要用内嵌 Python 来装依赖，而不是系统的 pip，否则会装到错误的环境里。
    .\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt
  3. 依赖装不下来的处理
    官方建议：先查 pip list 是否有版本不一致；再确认网络（中国大陆建议配置代理或使用清华镜像）；仍失败则检查是否需要用管理员权限运行命令行；必要时按 requirements.txt 里的确切版本逐个安装核心包，不要自行升级到最新版。
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
    pip install comfyui-frontend-package==<requirements.txt 中的版本号>

验证是否修好

启动日志中不再出现 Falling back to the default frontend；前端界面、工作流模板与节点帮助文档都能正常显示；pip list 中核心依赖版本与 ComfyUI/requirements.txt 一致。

补充说明

error_text 为官方中文更新文档中给出的回退日志原文；官方同时提示该条日志出现的含义是核心依赖更新失败。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [24] （官方文档）　如何更新 ComfyUI - ComfyUI　https://docs.comfy.org/zh/installation/update_comfyui
  2. [25] （官方 issue）　accidently ran "update_comfyui_and_python_dependencies.bat" and broke 　https://github.com/Comfy-Org/ComfyUI/issues/7415
  3. [26] （官方 issue）　AssertionError: Torch not compiled with CUDA enabled after running upd　https://github.com/Comfy-Org/ComfyUI/issues/11575
  4. [27] （官方 issue）　[Announcement] The frontend will no longer be shipped in the main Comf　https://github.com/Comfy-Org/ComfyUI/issues/7025

这条报错要用到的东西

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

环境与依赖配置包依赖版本组合清单 / 环境自检脚本说明 待挂载
节点库装扩展之后出问题的，多半是节点依赖没装全 板块

同一类别的其他条目

【001】双击 run_nvidia_gpu.bat 窗口一闪而过：c10.dll 缺失，需要安装 VC++ 运行库 有来源 【002】端口 8188 被占用：Address already in use / 上次的 ComfyUI 进程没退干净 有来源 【003】torch 加载失败：OSError [WinError 1114] 动态链接库(DLL)初始化例程失败 c10.dll 有来源 【004】便携版找不到内嵌 Python / 路径不对：'python' 不是内部或外部命令、系统找不到指定的路径 有来源 【005】用户名/路径含非 ASCII 字符或空格导致安装与启动失败 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库