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