ComfyUI чаще всего перестаёт работать из-за сломанных custom nodes, моделей в неправильной папке, нехватки VRAM или обновления, которое рассинхронизировало зависимости Python. Первый шаг всегда один: прочитать последние строки в консоли, а не в окне браузера. Именно там написана настоящая причина сбоя.
Почему браузер обманывает, а консоль нет
ComfyUI это две программы, работающие одновременно. Есть сервер на Python, который выполняет всю тяжёлую работу, и есть веб-страница, которая рисует граф нод. Когда ломается сервер, страница остаётся красивой и отзывчивой, в лучшем случае показывая невнятное всплывающее сообщение. Отсюда растёт самая частая формулировка проблемы: “нажимаю Queue Prompt, и ничего не происходит”. На экране действительно ничего не происходит, потому что ошибка произошла по другую сторону.
Поэтому правило диагностики простое. Держите окно консоли открытым рядом с браузером и смотрите в оба окна одновременно. Если после нажатия на генерацию консоль выдаёт несколько строк и останавливается, у вас исключение Python, и в последней строке будет его тип. Если консоль не пишет вообще ничего, запрос до сервера не дошёл, и проблема в связи между браузером и локальным сервером. Это две принципиально разные поломки, и путаница между ними является главной причиной, по которой люди переустанавливают всё подряд без всякого результата.
Если вы только собираете окружение и ещё не уверены, что базовая установка выполнена корректно, имеет смысл сначала пройти по структурированной инструкции вроде нашего разбора того, как выполняется установка ComfyUI для NSFW генерации, и только потом возвращаться к поиску конкретной неисправности. Диагностировать сломанную установку сложнее, чем поставить всё заново по шагам.
ComfyUI вообще не запускается
Сбой запуска означает, что сервер умирает до того, как напечатает адрес локального доступа. Классический симптом: чёрное окно появляется, прокручивает несколько строк и закрывается само. Если оно исчезает слишком быстро, откройте терминал вручную в папке ComfyUI и запустите стартовый скрипт оттуда. Тогда окно останется на месте, и вы прочитаете последнюю строку, а она единственная и важна.
Ошибка импорта модуля
Если в последней строке говорится про невозможность импортировать модуль, значит окружение Python неполное. Так бывает после ручного обновления пакетов, после установки другого проекта в то же самое окружение или после того, как антивирус удалил часть файлов. Лечится это переустановкой зависимостей из файла requirements внутри того окружения, которое реально использует ComfyUI. Ключевое слово здесь “того самого”: если у вас в системе несколько интерпретаторов Python, пакеты легко уезжают не туда, и вы будете чинить окружение, которое вообще не участвует в запуске.
Конфликт custom nodes
Это самая частая причина сбоя запуска у людей, которые пользуются ComfyUI дольше пары недель. Каждый custom node подгружается на старте, и любой из них может уронить весь процесс своей ошибкой. В консоли обычно видно имя папки расширения прямо перед сообщением об ошибке, и это готовый ответ.
Если имя не видно, работает грубый, но безотказный метод. Переименуйте папку custom_nodes целиком, добавив к названию любой суффикс, и запустите ComfyUI. Если он поднялся, виновник точно внутри. Верните имя обратно и переносите расширения назад по половине, каждый раз перезапуская программу. Так вы находите виновника за несколько итераций вместо перебора всего списка по одному.
Порт уже занят
Сообщение о занятом адресе означает, что предыдущая копия сервера не завершилась. Такое бывает после закрытия окна крестиком вместо остановки процесса. Проверьте список процессов Python и завершите зависший, либо запустите ComfyUI с другим номером порта через аргумент командной строки. Второй вариант быстрее, но помните, что адрес в браузере тоже придётся поменять, иначе вы будете открывать пустоту и думать, что сервер снова не поднялся.
Красные ноды в графе
Красная подсветка ноды означает ровно одно: интерфейс получил описание рабочего процесса, в котором есть узел, неизвестный текущей сборке. Это не поломка файла workflow и не вирус, это отсутствие расширения.
Ноды нет в системе
Чаще всего вы открыли чужой workflow, автор которого использовал расширение, которого у вас нет. Менеджер расширений внутри ComfyUI умеет искать недостающие ноды по имени и предлагать установку, и это самый спокойный путь. После установки обязательно перезапустите сервер целиком, потому что новые ноды регистрируются только при старте, а не на лету. Половина жалоб вида “установил, а нода всё равно красная” объясняется именно пропущенным перезапуском.
Нода есть, но устарела
Второй сценарий тоньше. Расширение установлено, но его версия ожидает другой набор входов. Тогда нода может подсвечиваться или молча падать при выполнении с жалобой на неизвестный аргумент. Здесь помогает обновление конкретного расширения, а не всего окружения сразу. Массовое обновление всех custom nodes одной кнопкой выглядит удобно, но регулярно ломает то, что до этого работало, и найти виновника потом гораздо сложнее.
Есть и третий вариант, о котором забывают: workflow может быть просто старым. Форматы графов меняются, и файл, скачанный давно, иногда содержит ноды, которые автор сам уже переименовал. Если workflow нужен ради конкретного эффекта, часто быстрее собрать похожую цепочку заново, чем реанимировать чужую. Особенно это касается сложных сборок с управлением позой, где логика подробно разобрана в материале про ControlNet и контроль поз.
Модели не загружаются и не видны в списке
Пустой выпадающий список чекпоинтов пугает новичков сильнее всего, хотя чинится он в среднем за минуту. Причин ровно три, и они проверяются по очереди.
Первая: файл лежит не в той папке. ComfyUI строго разделяет чекпоинты, LoRA, VAE, эмбеддинги и модели апскейла по отдельным каталогам. Файл LoRA, положенный к чекпоинтам, не появится нигде. Проверьте не только имя папки, но и то, что внутри нет лишнего вложенного каталога, который образовался при распаковке архива.
Вторая: ComfyUI смотрит в другое место. Если вы настраивали общий каталог моделей, чтобы не хранить копии для нескольких интерфейсов, значит существует конфигурационный файл с путями, и он важнее физического расположения файлов. Одна опечатка в пути, и программа честно показывает пустой список, потому что по указанному адресу действительно ничего нет.
Третья: файл повреждён или скачан не до конца. Прерванная загрузка даёт файл заметно меньше ожидаемого, и он либо не появляется в списке, либо выбирается, но роняет генерацию ошибкой чтения. Сравните размер с тем, что указан на странице загрузки, и качайте заново, если он подозрительно мал. Как правильно выбирать и проверять модели, подробно описано в руководстве по работе с Civitai.
Есть и четвёртая, редкая, но обидная причина. Некоторые сборки моделей выкладываются в форматах, которые текущая версия ComfyUI не читает без дополнительного расширения. Если файл имеет непривычное расширение, а список чекпоинтов упрямо пуст при правильном пути, посмотрите на страницу загрузки: обычно автор указывает, какой интерфейс поддерживает такой формат. Переименовывать файл, подгоняя расширение под ожидаемое, бесполезно и иногда приводит к падению при попытке загрузки, потому что меняется имя, а не содержимое.
Отдельно стоит проверить права доступа. Если папка с моделями лежит на внешнем диске, в облачной синхронизируемой директории или в системном каталоге, программа может не иметь права её читать. Симптом тот же самый, пустой список, но лечение другое: перенесите модели в обычную пользовательскую папку и укажите путь заново. Облачные каталоги вообще плохой сосед для тяжёлых файлов, потому что клиент синхронизации умеет держать файл как заглушку, и для программы он выглядит присутствующим, но пустым.
Нехватка VRAM: честный разговор
Ошибка нехватки памяти CUDA означает, что видеокарта физически не смогла разместить модель и промежуточные тензоры. Это не баг ComfyUI и не следствие кривой установки. Это арифметика, и её нельзя обойти уговорами.
Что реально помогает. Уменьшите разрешение генерации, потому что расход памяти растёт нелинейно и уменьшение стороны картинки экономит гораздо больше, чем кажется. Отключите апскейл в том же графе и вынесите его в отдельный проход. Уберите лишние ControlNet, потому что каждый добавляет свою модель в память. Запускайте ComfyUI с аргументами низкого потребления памяти, они замедляют работу, но позволяют довести задачу до конца. Закройте браузер с десятками вкладок и другие приложения, использующие видеокарту, они забирают память тихо и незаметно.
Что не помогает. Добавление оперативной памяти не заменяет VRAM. Переустановка драйвера не увеличивает объём памяти. И самое неприятное: если карта младшая, а модель тяжёлая, никакие настройки не сделают невозможное возможным. В этом случае честных путей два, и оба рабочие. Первый: перейти на более лёгкие модели и меньшие разрешения, подходы для слабого железа собраны в материале про нейросети на слабом ПК. Второй: вынести вычисления наружу, как описано в разборе аренды GPU в облаке.
Если генерация нужна прямо сейчас, а локальная сборка стоит колом, разумно не терять вечер и сделать нужные картинки в онлайн-сервисе, например через генератор, работающий в браузере, а к починке ComfyUI вернуться на свежую голову. Локальная установка ценна свободой настроек, но она не обязана быть единственным инструментом.
Всё сломалось после обновления
Обновление ComfyUI трогает три слоя сразу: код самого интерфейса, зависимости Python и совместимость custom nodes. Расширения обычно обновляются позже ядра, поэтому окно, в котором свежее ядро уже вышло, а расширения ещё нет, существует практически всегда.
Правильная последовательность действий выглядит так. Сначала прочитайте, на что именно жалуется консоль, потому что виновником может быть одно расширение из тридцати. Затем обновите только его. Если ошибка касается torch или xformers, значит обновление подтянуло несовместимую пару библиотек, и лечится это переустановкой связки целиком, а не отдельного пакета. Если понятного виновника нет, откатите ComfyUI на предыдущее состояние средствами системы контроля версий, дождитесь, пока экосистема расширений догонит ядро, и обновитесь снова через неделю.
Профилактика скучная, но работает. Делайте копию папки с рабочей сборкой перед крупным обновлением и сохраняйте важные workflow отдельно от программы. Тогда любое обновление становится обратимым, а не событием, после которого вы восстанавливаете рабочий процесс по памяти.
Полезно также разделять понятия обновления ядра и обновления моделей. Модели живут своей жизнью, они не ломаются от смены версии интерфейса и не требуют переустановки. Если после обновления вы вдобавок скачали новые чекпоинты и поменяли настройки, найти причину поломки станет вдвое сложнее, потому что изменений слишком много. Правило простое: одно изменение за раз, проверка, потом следующее. Оно кажется медленным ровно до первого случая, когда экономит вам целый вечер.
И последнее про обновления. Сообщения об ошибках, связанные с зависимостями, часто выглядят пугающе длинными, но информативна в них только последняя строка и имя пакета в ней. Всё, что выше, это трассировка вызовов, то есть путь, по которому программа дошла до сбоя. Читать её целиком не нужно. Скопируйте последнюю строку и ищите по ней, а не по всему тексту, иначе поиск даст чужие проблемы, не имеющие отношения к вашей.
Таблица быстрой диагностики
| Симптом | Вероятная причина | Первое действие |
|---|---|---|
| Окно консоли закрывается сразу | Исключение при импорте custom node | Запустить скрипт из открытого терминала и прочитать последние строки |
| Сообщение о занятом адресе | Старый процесс сервера не завершён | Завершить процесс Python или запустить на другом порту |
| Страница открывается, генерация не стартует | Сервер упал или браузер держит старую сессию | Смотреть консоль, обновить страницу с очисткой кеша |
| Нода подсвечена красным | Расширение не установлено или устарело | Установить недостающую ноду и перезапустить сервер |
| Список чекпоинтов пуст | Неверная папка или путь в конфигурации | Проверить каталог моделей и файл с путями |
| Ошибка нехватки памяти CUDA | Модель не помещается в VRAM | Снизить разрешение, убрать лишние модели из графа |
| Чёрное изображение на выходе | Проблема с VAE или точностью вычислений | Подключить внешний VAE, сменить режим точности |
| Всё сломалось после обновления | Расширения отстали от ядра | Обновить виновное расширение или откатить ядро |
Чёрный или серый результат вместо картинки
Отдельный класс жалоб выглядит так: процесс проходит до конца, прогресс доходит до ста процентов, а на выходе пустой чёрный прямоугольник. Ошибок в консоли при этом нет, и именно это сбивает с толку.
Самая частая причина: в графе не подключён подходящий VAE. Некоторые чекпоинты содержат VAE внутри, некоторые нет, и во втором случае декодирование даёт мусор. Подключите внешний VAE явной нодой и повторите генерацию. Вторая причина связана с режимом вычислений на некоторых видеокартах, где половинная точность даёт переполнение. Запуск с принудительной полной точностью решает вопрос ценой скорости. Третья причина банальна: слишком высокое значение CFG вместе с малым числом шагов выжигает изображение в равномерное пятно, и лечится это возвратом параметров к разумным значениям, о которых мы говорим в гайде по генерации на SDXL.
Когда чинить не нужно
Есть ситуации, в которых починка бессмысленна, и честнее признать это сразу. Если видеокарта не поддерживает нужные вычисления, ComfyUI не заработает ни при каких настройках. Если система не оставляет свободного места на диске, модели не загрузятся, сколько ни перезапускай. Если вы поставили сборку, собранную третьими лицами и упакованную в один архив, диагностировать её сложнее, чем поставить официальный вариант заново.
Полезно понимать и то, что ComfyUI не единственный интерфейс. Он даёт максимальную гибкость, но требует терпения. Если вам нужен предсказуемый результат без разбора графов, сравнение подходов есть в материале ComfyUI против Forge и A1111. Иногда правильный ответ на вопрос “почему не работает” звучит как “потому что этот инструмент не под вашу задачу”.
Порядок действий, если ничего не помогло
Соберите факты перед тем, как что-то менять. Запишите последнюю строку из консоли целиком, отметьте, что вы меняли перед появлением проблемы, и проверьте, воспроизводится ли ошибка на пустом workflow с одним чекпоинтом. Пустой минимальный граф это лучший тест: если он работает, поломка в вашей сборке нод, а не в программе. Если не работает даже он, проблема в окружении или в железе.
Дальше действуйте по нарастающей: перезапуск, обновление конкретного расширения, переустановка зависимостей, чистая установка в новую папку рядом со старой. Именно рядом, а не поверх, потому что старую папку вы всегда сможете удалить, а восстановить её после перезаписи уже нет. Обучение собственных моделей и другие тяжёлые сценарии стоит откладывать до момента, когда базовая генерация стабильна, подробности собраны в руководстве по обучению LoRA. И если срок горит, а сборка всё ещё лежит, спокойно закройте задачу через онлайн-генератор без установки и вернитесь к отладке позже.
Часто задаваемые вопросы
Почему ComfyUI открывается, но кнопка генерации ничего не делает?
Скорее всего сервер упал, а страница в браузере осталась от предыдущей сессии. Посмотрите в консоль: если она пустая и не реагирует на нажатие, соединение потеряно. Обновите страницу с очисткой кеша, а если это не помогло, перезапустите сервер и убедитесь, что в консоли снова появился адрес локального доступа перед тем, как открывать браузер.
Как быстро понять, какой именно custom node ломает запуск?
Имя папки расширения почти всегда печатается в консоли прямо перед сообщением об ошибке, поэтому начните с чтения последних строк. Если имени нет, переименуйте папку custom_nodes целиком и проверьте, поднимается ли программа. Затем возвращайте расширения обратно половинами, перезапуская сервер после каждого шага. Виновник находится за несколько итераций вместо перебора всего списка.
Модель лежит в нужной папке, но не появляется в списке. Почему?
Проверьте три вещи по очереди. Первое: нет ли внутри папки лишнего вложенного каталога, созданного архиватором при распаковке. Второе: не переопределены ли пути в конфигурационном файле, тогда программа читает совсем другой каталог. Третье: полностью ли скачан файл, потому что оборванная загрузка даёт файл сильно меньше ожидаемого. И перезапустите сервер, список обновляется не всегда автоматически.
Помогает ли полная переустановка ComfyUI?
Иногда помогает, но это последний шаг, а не первый. Переустановка снимает симптом, не объясняя причину, и через месяц вы вернётесь к тому же состоянию. Если решились, ставьте новую копию в отдельную папку рядом со старой, а модели подключите через общий каталог. Тогда вы сравните поведение двух сборок и ничего не потеряете при неудаче.
Что означает ошибка нехватки памяти CUDA?
Она означает, что видеокарте не хватило VRAM для размещения модели и промежуточных данных. Снизьте разрешение, уберите из графа лишние вспомогательные модели, вынесите апскейл в отдельный проход и закройте приложения, которые тоже используют видеокарту. Если карта младшая, а модель тяжёлая, настройками это не решается, и разумнее перейти на более лёгкие модели или считать в облаке.
Можно ли запустить ComfyUI без дискретной видеокарты?
Формально запуск на процессоре возможен, но практическая ценность у него небольшая: одна картинка считается настолько долго, что подбор промпта превращается в мучение. Для редких экспериментов такой режим годится, для регулярной работы нет. Реалистичные варианты при слабом железе это лёгкие модели, небольшие разрешения либо аренда вычислений в облаке на время работы.
Почему старый workflow перестал открываться после обновления?
Форматы графов и наборы входов у нод меняются со временем, поэтому файл, сохранённый давно, может ссылаться на ноды, которых больше не существует под прежними именами. Установите недостающие расширения через менеджер, обновите те, что подсвечены, и перезапустите сервер. Если workflow совсем древний, часто быстрее собрать похожую цепочку заново, чем восстанавливать чужую.
Стоит ли откатывать ComfyUI на предыдущую версию?
Да, если после обновления сломалось сразу многое и понятного виновника в консоли нет. Откат средствами системы контроля версий возвращает рабочее состояние за минуты и даёт экосистеме расширений время догнать ядро. Через некоторое время обновитесь снова, предварительно сделав копию рабочей папки. Регулярные копии превращают любое обновление в обратимое действие.
