【笔记】修复 ComfyUI 安装 ComfyUI-nunchaku 相关节点和 nunchaku 库之后启动出现 ‘nunchaku_versions.json‘ not found.‘ 错误

***fyUI-nunchaku 配置文件错误修复教程

【笔记】***fyUI-Nunchaku 版本兼容性问题修复笔记

问题描述

在安装 ***fyUI-nunchaku 和相关节点后，启动 ***fyUI 时出现以下错误：

'nunchaku_versions.json' not found. Node will start in minimal mode.

错误分析

这个错误通常发生在以下情况：

1. 配置文件缺失：nunchaku 节点需要 nunchaku_versions.json 配置文件
2. 文件格式错误：即使文件存在，如果格式不正确也会导致错误
3. 权限问题：节点可能没有足够的权限读取配置文件

修复步骤

步骤 1：定位问题节点目录

打开命令提示符，进入 ***fyUI-nunchaku 目录：

cmd

cd H:\PythonProjects1\Win_***fyUI\custom_nodes\***fyUI-nunchaku

步骤 2：检查配置文件是否存在

cmd

dir nunchaku_versions.json

如果显示 "找不到文件"，则需要创建配置文件。

步骤 3：创建正确格式的配置文件

方法 1：使用 echo 命令创建

cmd

:: 创建配置文件
echo { > nunchaku_versions.json
echo   "versions": ["latest", "1.0.1"] >> nunchaku_versions.json
echo } >> nunchaku_versions.json

方法 2：使用 PowerShell 创建（推荐）

cmd

powershell -***mand "@{
  'versions' = @('latest', '1.0.1')
} | ConvertTo-Json | Set-Content 'nunchaku_versions.json' -Encoding utf8"

步骤 4：验证文件内容

cmd

type nunchaku_versions.json

正确的文件内容应该是：

json

{
  "versions": ["latest", "1.0.1"]
}

步骤 5：检查文件权限

cmd

:: 检查文件属性
attrib nunchaku_versions.json

:: 如果是只读，移除只读属性
attrib -r nunchaku_versions.json

步骤 6：更新 nunchaku 节点（可选）

双节棍技术/***fyUI-nunchaku：双节棍的***fyUI插件

cmd

:: 更新到最新版本
cd H:\PythonProjects1\Win_***fyUI\custom_nodes\***fyUI-nunchaku
git pull
pip install -r requirements.txt

步骤 7：验证修复结果

启动 ***fyUI 验证问题是否解决：

cmd

cd H:\PythonProjects1\Win_***fyUI
python main.py

常见问题及解决方案

问题 1：JSON 格式错误

错误信息：

plaintext

Error reading or parsing 'nunchaku_versions.json': Expecting property name enclosed in double quotes

解决方案：确保使用双引号，而不是单引号：

json

{
  "versions": ["latest", "1.0.1"]  // 正确
}

问题 2：类型错误

错误信息：

plaintext

TypeError: can only concatenate list (not "dict") to list

解决方案：确保 "versions" 的值是列表，而不是字典：

json

{
  "versions": ["latest", "1.0.1"]  // 正确
}

问题 3：网络连接问题

错误信息：

plaintext

Error fetching version info <urlopen error _ssl.c:993: The handshake operation timed out>

解决方案：这是网络问题，可以忽略或更新 albumentations：

cmd

pip install --upgrade albumentations

预防措施

1. 定期备份配置文件
2. 在更新节点前备份
3. 保持节点版本最新
4. 检查网络连接稳定性

总结

通过创建正确格式的 nunchaku_versions.json 配置文件，大多数与 nunchaku 相关的启动错误都可以解决。如果问题依旧，可以尝试：

1. 重新安装 nunchaku 节点
2. 检查文件权限和网络连接
3. 临时禁用问题节点

记住，大多数警告不会影响 ***fyUI 的核心功能，可以安全地继续使用。