Почему workflow открывается с красными нодами
Почему workflow в ComfyUI открывается с красными нодами: как найти отсутствующий пакет, проверить import failed и восстановить граф.
Короткий ответ. Красная нода в открытом workflow означает, что ComfyUI не смог сопоставить узел из сохранённого графа с доступной нодой в вашей установке. Чаще всего отсутствует пакет кастомных нод, но установка пакета сама по себе не гарантирует исправление: он может не загрузиться из-за зависимости, изменённого имени или несовместимой версии.
Сначала сохраните копию графа
Не удаляйте красные блоки сразу. В них сохраняются связи, значения и место в цепочке. Сохраните исходный JSON отдельно, а диагностику проводите на копии. Если несколько красных нод входят в одну ветку, часто все они принадлежат одному пакету. Запишите точные имена узлов, а не только цвет.
Проверка в правильном порядке
- Найдите отсутствующие типы. Откройте сообщение при импорте workflow или функцию поиска недостающих нод в Manager. Запишите список.
- Проверьте пакет. Если Manager предлагает расширение, сравните его описание и репозиторий с документацией автора workflow. Похожие названия не всегда означают тот же код.
- Установите и полностью перезапустите ComfyUI. Обновление страницы браузера не заставляет Python повторно импортировать новый пакет.
- Посмотрите журнал загрузки. Строка
IMPORT FAILEDили трассировка ошибки показывает, что каталог есть, но нода не стала доступной. - Откройте JSON заново. Проверьте, исчезли ли красные блоки и сохранились ли связи.
- Проверьте модели отдельно. Если узлы стали обычными, но запуск не идёт, ищите пустые поля checkpoint, VAE, энкодера или LoRA.
Функция Install Missing Custom Nodes описана в README ComfyUI-Manager. Она показывает кандидатов для отсутствующих типов, однако не может автоматически исправить каждый несовместимый или переименованный узел.
Как понять причину по симптому
| Что видно | Вероятная причина | Следующая проверка |
|---|---|---|
Пакета нет в custom_nodes |
Нода не установлена | Установка из доверенного репозитория |
| Папка пакета есть, но нода красная | Пакет не импортировался | Журнал запуска и зависимости |
| Нода установлена, но её имя другое | Изменённый тип или версия workflow | README и история версий пакета |
| Красных нод нет, запуск падает | Модель, соединение или параметры | Первая ошибка выполнения |
| Проблема появилась после обновления | Несовместимое изменение | Версии ComfyUI и пакета |
Почему Manager не всегда находит нужный пакет
Тип узла в JSON и название репозитория на GitHub могут отличаться. Пакет мог сменить имя, переехать или не иметь записи в каталоге Manager. Не устанавливайте наугад несколько «похожих» расширений: это усложнит диагностику. Найдите страницу автора workflow или исходный репозиторий ноды и проверьте, есть ли там указанное имя узла. Если пакет больше не поддерживается, ищите документированный аналог и вручную перенесите связи в копии графа.
Если пакет установлен, но ноды остаются красными
Сначала проверьте журнал. Сообщения о недостающем модуле Python означают, что зависимость установлена не полностью или не в то окружение. Для Desktop, portable и облачных сборок команды установки могут отличаться. Следуйте README пакета и используйте Python именно той установки, которая запускает ComfyUI. После исправления зависимости нужен новый запуск сервера.
Если журнал чистый, сравните версии ComfyUI и пакета. Авторы иногда меняют названия узлов и входов. У старого JSON могут остаться ссылки на больше не существующие типы. Тогда найдите предыдущую совместимую версию пакета либо замените узлы по инструкции автора, сохранив исходный файл.
Что красный цвет не означает
Красный блок сам по себе не доказывает, что не хватает видеопамяти или что скачана неправильная модель. Эти ошибки чаще проявляются после начала выполнения. И наоборот, исчезновение красных блоков не доказывает, что workflow полностью готов: в загрузчиках могут остаться пустые поля или пути к файлам автора графа.
Минимальный чек-лист
- Сохранена копия исходного workflow.
- Записаны точные имена красных узлов.
- Установлен нужный пакет из проверенного источника.
- ComfyUI перезапущен; в журнале нет ошибки импорта.
- JSON открыт заново; модели выбраны вручную.
- Сделан короткий тестовый прогон.
Если именно установка недостающих типов вызывает трудности, см. отдельную инструкцию по missing custom nodes. Для обычной установки через Manager есть отдельный материал про ComfyUI Manager.