Как читать логи ComfyUI-Manager при запуске
Как читать логи ComfyUI-Manager при запуске: отличить сбой загрузки пакета от ошибки импорта, найти первую причину и восстановить ноды.
Короткий ответ. Логи ComfyUI-Manager при запуске помогают отделить ошибку установки ноды от ошибки загрузки самой ноды. Сначала найдите строку с именем пакета и первый traceback выше финального сообщения IMPORT FAILED. Затем проверьте, какой Python запустил ComfyUI, установились ли зависимости и совпадает ли версия ноды с версией ComfyUI. [ComfyUI-Manager: документация]
Где находятся сообщения запуска
Если ComfyUI запущен из терминала, основной журнал — вывод этого терминала. В portable-сборке это окно запуска, а на облачном pod — логи процесса или терминал внутри pod. Manager может также писать отдельный лог, если включено логирование. Его настройки и путь к config.ini выводятся при старте; не предполагайте одинаковый путь во всех установках. [README Manager]
При поиске ошибки сохраните лог от запуска до сообщения о готовности сервера. Последние десять строк часто показывают только следствие. Пароли, токены, приватные ссылки и личные пути перед публикацией фрагмента лога удалите.
Как отличить стадии ошибки
| Сообщение | Что обычно означает | Что проверить |
|---|---|---|
| Не удалось скачать пакет | Проблема доступа к репозиторию или установки | URL, сеть, разрешения, доступное место |
ModuleNotFoundError |
Библиотека отсутствует в Python текущего ComfyUI | Используемое окружение и requirements пакета |
IMPORT FAILED |
Папка ноды есть, но импорт не прошёл | Первый traceback и зависимости |
| Нода не найдена в workflow | Пакет не загрузился или нужна другая версия | Имя пакета, переименование ноды, совместимость |
Главное различие: наличие папки в custom_nodes не доказывает, что Python смог импортировать её код. И наоборот, красный блок в workflow не всегда означает, что пакет вовсе не установлен: автор мог изменить имя ноды или формат графа. Manager умеет показывать сведения об отсутствующих нодах и о неудачном импорте. [ComfyUI-Manager]
Порядок диагностики без переустановки всего ComfyUI
- Запишите имя красной ноды из workflow и название связанного пакета в Manager.
- В логе найдите первое появление имени пакета и первую ошибку после него.
- Сверьте Python, которым запускается ComfyUI, с Python, в который ставились зависимости. В portable-сборке это особенно важно.
- Прочитайте README именно установленной ноды: иногда нужны отдельные модели, системные библиотеки или версия ComfyUI.
- Исправьте одну причину, полностью перезапустите процесс и сравните новый лог со старым.
Не устанавливайте все пакеты из интернета подряд по одному слову из traceback. Например, ошибка может происходить из-за несовместимой версии уже установленной библиотеки. Смотрите всю цепочку: строку импорта, имя пакета и требования репозитория. [ComfyUI: установка кастомных нод]
Если на одном компьютере установлено несколько копий ComfyUI, сверьте папку проекта с путём в строках запуска. Частая ловушка: пакет исправлен в одной копии, а браузер по-прежнему подключён к другой. Номер порта и каталог запуска помогут понять, какой процесс сейчас открыт. После исправления запустите простой граф с одной проблемной нодой: так легче увидеть, ушла ли исходная ошибка, прежде чем возвращаться к большому workflow.
Когда полезен снимок окружения
Перед массовым обновлением Manager создайте snapshot или сохраните список пакетов и версий. Так проще вернуться к рабочему состоянию, если обновление ломает старый workflow. Для воспроизведения проблемы запишите версию ComfyUI, тип установки, ОС, версию Python, название пакета, шаги и короткий безопасный фрагмент traceback. Эти данные полезнее скриншота одной красной ноды. [README Manager]
Короткие ответы
Можно ли исправить ошибку кнопкой Refresh?
Refresh обновляет интерфейс, но не перезапускает процесс Python. После установки зависимостей или изменения файлов ноды обычно требуется полноценный перезапуск ComfyUI.
Что делать, если ошибка появилась после обновления?
Сравните версии пакета до и после обновления, проверьте issues его репозитория и восстановите рабочую версию или snapshot. Не меняйте одновременно ComfyUI, Python и все ноды: так трудно определить причину.