解决 ComfyUI 模块'openrouter_banana' 和 'comfly_nano_banana' 加载失败问题：完整修复指南
问题背景
在使用 ComfyUI 时，很多用户都会遇到类似的模块加载失败错误：
在安装了 OpenRouter Banana 插件和 Comfly Nano Banana 插件后
OpenRouter Banana 插件 GitHub 仓库：https://github.com/gabe-init/ComfyUI-Openrouter_node
Comfly Nano Banana 插件 GitHub 仓库：https://github.com/darkamenosa/comfy_nanobanana
[LLM Prompt] OpenRouter Banana module loading failed: No module named 'openrouter_banana'
[LLM Prompt] Comfly Nano Banana module loading failed: No module named 'comfly_nano_banana'
这些错误会导致 ComfyUI 功能不完整，影响使用体验。本文将详细记录我如何成功解决这些问题的完整过程。
问题分析
错误原因
经过深入分析，我发现这些错误的根本原因是模块命名不匹配：
- OpenRouter Banana：系统正在寻找openrouter_banana模块
- Comfly Nano Banana：系统正在寻找comfly_nano_banana模块
但这些模块在 GitHub 上的实际仓库名称可能不同，导致 ComfyUI 无法找到它们。
关键发现
在修复过程中，我发现了一个重要提示：
✅ nano-banana官方调用方式已集成到gemini_banana模块
这表明有些功能可能已经内置在其他模块中，但系统仍然在尝试加载旧的模块名称。
修复过程
准备工作
首先，确保你在正确的环境中操作：
# 激活虚拟环境
cd H:\PythonProjects1\Win_ComfyUI
.venv\Scripts\activate修复 OpenRouter Banana 模块
步骤 1：找到正确的仓库
经过搜索，我找到了 OpenRouter Banana 的官方仓库：
- GitHub 仓库：https://github.com/gabe-init/ComfyUI-Openrouter_node
- 开发者：gabe-init
步骤 2：克隆到正确的目录
关键在于将仓库克隆到系统期望的目录名称：
# 进入custom_nodes目录
cd H:\PythonProjects1\Win_ComfyUI\custom_nodes
# 克隆仓库到openrouter_banana目录
git clone https://github.com/gabe-init/ComfyUI-Openrouter_node.git openrouter_banana
步骤 3：安装依赖
# 进入模块目录
cd openrouter_banana
# 安装依赖
pip install -r requirements.txt --no-deps
修复 Comfly Nano Banana 模块
步骤 1：找到正确的仓库
经过搜索，我找到了 Comfy Nano Banana 的官方仓库：
- GitHub 仓库：https://github.com/darkamenosa/comfy_nanobanana
- 开发者：darkamenosa
步骤 2：克隆到正确的目录
同样，关键在于目录名称：
# 进入custom_nodes目录
cd H:\PythonProjects1\Win_ComfyUI\custom_nodes
# 克隆仓库到comfly_nano_banana目录
git clone https://github.com/darkamenosa/comfy_nanobanana.git comfly_nano_banana
步骤 3：安装依赖
# 进入模块目录
cd comfly_nano_banana
# 安装依赖
pip install -r requirements.txt --no-deps
验证修复结果
重启 ComfyUI 后，检查输出：
[LLM Prompt] OpenRouter Banana module loaded successfully
[LLM Prompt] Comfly Nano Banana module loaded successfully
同时，节点数量从 15 个增加到 18 个，新增了：
- OpenRouterNode - 来自 OpenRouter Banana
- NanoBananaGeminiImageNode - 来自 Comfy Nano Banana
- BatchImages - 来自 Comfy Nano Banana
常见问题及解决方案
问题 1：相对导入错误
在修复过程中，我遇到了相对导入问题：
ImportError: attempted relative import with no known parent package
解决方案：确保克隆到正确的目录名称，让 Python 能够正确解析模块结构。
问题 2：模块已存在但功能不完整
解决方案：检查是否安装了所有依赖，确保使用pip install -r requirements.txt安装完整的依赖包。
问题 3：Google Cloud 凭证错误
An unexpected error occurred during NanoBanana initialization: Your default credentials were not found.
解决方案：这是使用 Google Gemini API 的必要步骤，需要设置 Google Cloud 凭证。
修复成功的标志
模块加载状态
所有模块都应显示 "loaded successfully"：
[LLM Prompt] GLM module loaded successfully ✓
[LLM Prompt] Comfly module loaded successfully ✓
[LLM Prompt] JoyCaption module loaded successfully ✓
[LLM Prompt] Gemini module loaded successfully ✓
[LLM Prompt] Gemini Banana module loaded successfully ✓
[LLM Prompt] Gemini Banana Mirror module loaded successfully ✓
[LLM Prompt] OpenRouter Banana module loaded successfully ✓
[LLM Prompt] Comfly Nano Banana module loaded successfully ✓
节点数量
节点数量应增加到 18 个：
[LLM Agent Assistant] Registered 18 nodes ✓
总结
关键要点
- 目录名称至关重要：确保克隆到系统期望的目录名称
- 安装完整依赖：使用requirements.txt安装所有必要的包
- 验证修复结果：检查模块加载状态和节点数量
修复成果
通过这个修复过程，我成功解决了两个模块加载失败的问题，使 ComfyUI 恢复了完整功能：
- ✅ 消除了所有模块加载错误
- ✅ 恢复了 18 个功能节点
- ✅ 可以正常使用 OpenRouter 和 NanoBanana 相关功能
后续建议
- 定期更新模块：保持模块为最新版本
- 备份配置：定期备份 custom_nodes 目录
- 关注官方更新：注意功能集成的变化
希望这篇博客能帮助遇到类似问题的 ComfyUI 用户成功解决模块加载失败的问题！
发布时间：2025 年 11 月 23 日
关键词：ComfyUI, 模块修复，OpenRouter Banana, Comfy Nano Banana, 技术教程
浙公网安备 33010602011771号