ComfyUI 报错修复:RES4LYF插件 JSONDecodeError 空文件解析失败

11次阅读
没有评论

很多小伙伴在启动ComfyUI时,会遇到 RES4LYF 自定义节点加载失败的报错,程序无法正常启动,核心报错信息统一且固定。今天给大家完整拆解报错根源、成因,以及从简单到彻底的全套修复方案,零基础也能轻松搞定。

一、完整报错信息

json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)

二、报错核心根源

这个报错的本质非常简单:RES4LYF 插件的JSON配置文件为空/损坏

ComfyUI启动加载自定义节点时,会读取该插件的核心配置JSON文件,但文件内部是0字节空白内容,没有任何合法的JSON数据,导致解析程序读取不到有效信息,直接加载崩溃,最终插件加载失败、ComfyUI启动报错。

报错完整链路

ComfyUI启动 → 加载RES4LYF自定义节点 → 执行插件初始化程序 → 读取插件JSON配置文件 → 文件空白损坏 → JSON解析失败 → 插件加载终止

三、报错产生的常见原因

很多人以为是代码bug,其实大多是本地文件异常导致,常见4种情况:

  • 文件下载/解压异常:插件安装、解压过程中断,导致配置文件缺失、空白损坏
  • 杀毒软件拦截篡改:电脑管家、Windows Defender误判插件文件,清空或隔离文件内容
  • 手动操作失误:手动修改插件目录内的JSON配置,误清空全部内容、保存空文件
  • 版本更新残留问题:插件更新迭代后,旧版损坏配置文件未覆盖,残留异常文件

四、全套修复方案(由简到繁,优先首选方案)

方案一:删除损坏配置文件,自动重置(首选、最简单)

插件自带自动生成默认配置的机制,直接删除损坏文件即可自愈,无需重装插件。

  1. 打开报错对应的插件目录:C:\Work\ComfyUI_windows_portable_nvidia\ComfyUI_windows_portable\ComfyUI\custom_nodes\RES4LYF\
  2. 在文件夹内找到配置文件,一般为 config.jsonextension.jsonmanifest.json
  3. 直接删除该空白/损坏的JSON文件
  4. 重启ComfyUI,插件会自动生成完好的默认配置文件,报错直接解决

方案二:手动修复空JSON文件(无需删文件)

不想删除文件的小伙伴,可直接手动写入合法JSON代码,绕过解析报错。

  1. 用记事本/VS Code打开报错的空白JSON文件
  2. 清空所有空白内容,粘贴标准空JSON代码:{}
  3. 保存文件,重启ComfyUI即可正常加载插件

原理:一对空大括号是合法的JSON空对象,可被程序正常解析,不会触发报错。

方案三:重装RES4LYF插件(方案无效兜底)

若配置文件反复损坏,直接重装插件彻底解决问题,提供两种安装方式:

方式1:ComfyUI管理器重装(推荐)

  1. 打开ComfyUI,进入 ComfyUI Manager
  2. 点击 Install Custom Nodes,切换至已安装列表 Installed
  3. 找到RES4LYF,点击卸载 Uninstall
  4. 卸载完成后,重新搜索安装最新版RES4LYF插件
  5. 完全关闭ComfyUI后重启生效

方式2:手动彻底重装

  1. 关闭所有ComfyUI窗口,结束后台进程
  2. 进入 custom_nodes目录,直接删除整个RES4LYF文件夹
  3. 重启一次ComfyUI,确认报错消失
  4. 从官方仓库重新下载插件压缩包,解压至custom_nodes目录
  5. 再次启动ComfyUI即可正常使用

方案四:临时禁用插件(紧急开机兜底)

如果暂时不需要该插件,只想正常启动ComfyUI绘图,可直接禁用插件规避报错:

  1. 找到 custom_nodes 目录下的 RES4LYF 文件夹
  2. 将文件夹重命名为 RES4LYF_disable
  3. ComfyUI会自动忽略带禁用标识的文件夹,启动无报错,不影响其他节点使用

五、长期避坑小贴士

  • 安装插件时关闭杀毒软件、Windows实时防护,避免文件被误篡改、清空
  • 尽量不要用系统自带记事本编辑JSON文件,优先使用VS Code,避免编码异常导致文件损坏
  • 若频繁出现文件空白损坏,可检查硬盘读写状态,排查磁盘异常问题
  • 插件更新不要强制覆盖安装,建议旧版卸载后再安装新版,避免配置残留冲突

总结

该报错非代码故障,纯本地配置文件损坏/空白导致,99%的情况通过「删除损坏JSON配置自动重置」即可一键修复,无需复杂调试,新手直接套用方案即可解决问题。

正文完
可以使用微信扫码关注公众号(ID:xzluomor)
post-qrcode
 0
评论(没有评论)
验证码