ComfyUI-Manager模块导入错误：解决'toml'模块缺失问题

问题背景

在使用ComfyUI-Manager时，用户可能会遇到一个常见的Python模块导入错误："ModuleNotFoundError: No module named 'toml'"。这个错误通常发生在更新ComfyUI或ComfyUI-Manager后，导致管理器无法正常加载。

错误分析

错误日志显示，系统在尝试导入ComfyUI-Manager时，无法找到必需的'toml'模块。这个模块是Python中用于解析和生成TOML(一种配置文件格式)的标准库替代品。ComfyUI-Manager依赖这个模块来处理配置文件。

典型的错误堆栈如下：

Traceback (most recent call last):
  File "nodes.py", line 1993, in load_custom_node
    module_spec.loader.exec_module(module)
  File "<frozen importlib._bootstrap_external>", line 940, in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "custom_nodes/comfyui-manager/__init__.py", line 8, in <module>
    import manager_server
  File "custom_nodes/comfyui-manager/glob/manager_server.py", line 17, in <module>
    import manager_core as core
  File "custom_nodes/comfyui-manager/glob/manager_core.py", line 37, in <module>
    import cnr_utils
  File "custom_nodes/comfyui-manager/glob/cnr_utils.py", line 5, in <module>
    import toml
ModuleNotFoundError: No module named 'toml'

解决方案

方法一：更新ComfyUI-Manager

1. 导航到ComfyUI安装目录下的custom_nodes/comfyui-manager文件夹
2. 执行git pull命令获取最新版本
3. 重启ComfyUI

方法二：手动安装toml模块

如果更新后问题仍然存在，可以尝试手动安装toml模块：

对于Windows用户：

1. 打开命令提示符
2. 导航到ComfyUI的Python环境目录
3. 执行：pip install toml

对于Linux用户：

1. 打开终端
2. 确保在正确的Python环境下
3. 执行：pip install toml

方法三：完整环境重置

如果上述方法无效，可以考虑：

1. 备份custom_nodes目录
2. 删除并重新克隆ComfyUI-Manager仓库
3. 确保Python环境完整

预防措施

为避免类似问题：

1. 定期更新ComfyUI和所有扩展
2. 在更新前备份重要工作流
3. 关注项目的更新日志和已知问题

技术原理

TOML模块是Python中处理TOML格式文件的工具。ComfyUI-Manager使用它来解析和生成配置文件。当Python环境中缺少这个依赖时，就会导致模块导入失败。新版本的ComfyUI-Manager已经包含了必要的依赖声明，确保在安装时自动获取所有必需的模块。

通过理解这个问题的根源和解决方案，用户可以更好地维护他们的ComfyUI环境，确保所有功能正常工作。