Ошибки Stable Diffusion: диагностика и решения

Ошибка CUDA out of memory при генерации изображения в Stable Diffusion почти всегда означает, что видеокарте не хватило видеопамяти под выбранное разрешение и размер батча — и это лишь одна из десятков типичных проблем, с которыми сталкиваются пользователи нейросети. Сбои возникают на всех этапах: от установки AUTOMATIC1111 или ComfyUI до загрузки чекпоинтов и запуска генерации.

В этом материале разобраны самые распространённые ошибки Stable Diffusion: проблемы с видеопамятью, зависимостями Python, моделями, расширениями и веб-интерфейсом. Для каждой ситуации приведены безопасные шаги диагностики, которые не требуют переустановки системы или рискованных манипуляций. Начинайте с простых проверок — в большинстве случаев причина оказывается проще, чем кажется.

Ошибка CUDA out of memory: нехватка видеопамяти

Сообщение RuntimeError: CUDA out of memory появляется, когда генерация требует больше VRAM, чем физически доступно на видеокарте. Типичные триггеры — высокое разрешение изображения, большой размер батча, включённый Hires. fix или одновременно запущенные программы, потребляющие видеопамять (браузер с множеством вкладок, игры, другие нейросети).

Первое действие — снизить нагрузку. Уменьшите разрешение до 512×512, установите Batch size равным 1 и закройте лишние приложения. Если карта имеет мало видеопамяти, запустите веб-интерфейс с параметрами оптимизации. Для этого отредактируйте файл webui-user.bat, добавив в строку COMMANDLINE_ARGS нужные флаги:

set COMMANDLINE_ARGS=--medvram --xformers

Флаг --medvram снижает потребление памяти ценой скорости, а при совсем слабых картах используют --lowvram. Установка xformers дополнительно оптимизирует работу механизма внимания. Учтите, что поддержка конкретных флагов зависит от версии интерфейса — актуальный список смотрите в документации вашей сборки.

Ошибки при установке и запуске веб-интерфейса

Если webui-user.bat завершается с ошибкой сразу после запуска, чаще всего виноваты окружение и зависимости. Типичные симптомы: ModuleNotFoundError, сообщения о несовместимой версии Python или сбой при клонировании репозиториев через Git.

  • 🐍 Проверьте версию Python командой python --versionAUTOMATIC1111 традиционно требует Python 3.10.x, другие версии могут вызывать конфликты зависимостей.
  • 📁 Убедитесь, что путь к папке установки не содержит кириллицы и пробелов — это частая причина сбоев скриптов.
  • 🌐 Проверьте доступность GitHub: обрыв сети при клонировании репозиториев приводит к неполной установке.
  • 🔄 Удалите папку venv внутри каталога веб-интерфейса и запустите установку заново — виртуальное окружение пересоздастся с чистого листа.

Отдельная категория проблем — устаревший Git или его отсутствие в системной переменной PATH. Если установщик сообщает, что не может найти git, переустановите его с официального сайта и при установке отметьте опцию добавления в PATH.

⚠️ Внимание: не скачивайте «готовые сборки» Stable Diffusion с непроверенных ресурсов — в архивах могут быть подменённые скрипты. Используйте официальные репозитории проектов.
📊 С какой ошибкой Stable Diffusion вы сталкивались чаще всего?
CUDA out of memory
Ошибки при установке
Модель не загружается
Чёрные или битые изображения

Проблемы с моделями и чекпоинтами

Модель скачана, помещена в models/Stable-diffusion, но не появляется в списке или выдаёт ошибку при загрузке. Возможных причин несколько, и проверять их стоит по порядку.

Во-первых, файл мог скачаться не полностью — прерванная загрузка даёт битый чекпоинт, который не загружается. Сравните размер файла с указанным на странице источника. Во-вторых, формат .safetensors предпочтительнее .ckpt: файлы ckpt исполняют код при загрузке, что и менее безопасно, и чаще вызывает конфликты. В-третьих, модели для SDXL и SD 1.5 несовместимы между собой — чекпоинт одной архитектуры не заработает с настройками другой.

Где искать лог ошибок

Полный текст ошибки выводится в консоль (чёрное окно командной строки), которое открывается вместе с веб-интерфейсом. Ищите последний блок, начинающийся со слова Traceback, — именно последняя строка этого блока содержит суть проблемы.

Если модель загружается, но генерация обрывается на середине, проверьте свободное место на диске и стабильность ОЗУ. Большие чекпоинты при подгрузке могут занимать заметный объём оперативной памяти, особенно в связке с флагом --lowvram, который переносит часть данных с видеокарты в RAM.

Чёрные, зелёные или искажённые изображения

Чёрный квадрат вместо результата — узнаваемый симптом. Одна из возможных причин — срабатывание встроенного фильтра NSFW, который заменяет изображение чёрным полем. Другая частая причина — численная нестабильность при работе в половинной точности (fp16) на некоторых видеокартах, особенно старых моделях.

Попробуйте запустить интерфейс с параметрами --no-half --precision full — генерация станет медленнее и прожорливее по памяти, но исключит ошибки вычислений. Также проверьте значения CFG Scale и числа шагов: экстремально высокие значения иногда приводят к «пережжённым» или разваленным картинкам. Если изображения искажены только при использовании VAE из комплекта чекпоинта, скачайте внешний VAE-файл или переключитесь на встроенный (Automatic) в настройках.

☑️ Диагностика чёрных изображений

Выполнено: 0 / 5

Ошибки расширений и конфликты версий

Расширения для AUTOMATIC1111 — частый источник сбоев после обновления самого интерфейса. Симптомы: веб-UI не стартует, выдаёт ImportError или отдельные вкладки перестают работать.

Действуйте методом исключения. Переименуйте папку extensions, запустите интерфейс в чистом виде — если всё работает, возвращайте расширения по одному, пока не найдёте проблемное. Альтернатива — флаг --disable-all-extensions, если он поддерживается вашей версией. После обновления веб-интерфейса через git pull всегда проверяйте совместимость установленных дополнений.

ОшибкаВероятная причинаПервое действие
CUDA out of memoryНе хватает VRAMСнизить разрешение и batch size
ModuleNotFoundErrorБитое окружение или версия PythonПересоздать папку venv
Модель не появляется в спискеНедокачанный файл или неверная папкаСверить размер файла и путь
Чёрное изображениеNSFW-фильтр или ошибки fp16Флаг --no-half, смена VAE
ImportError после обновленияНесовместимое расширениеОтключить расширения и включать по одному
⚠️ Внимание: не обновляйте веб-интерфейс и все расширения одновременно — при сбое будет невозможно понять, что именно сломало систему. Обновляйте по очереди и проверяйте работоспособность после каждого шага.

Медленная генерация и ошибки драйверов

Генерация занимает минуты вместо секунд? Проверьте, действительно ли используется видеокарта. Сообщение вида running on CPU в консоли означает, что PyTorch не видит GPU — обычно из-за отсутствия CUDA-совместимой версии библиотеки или устаревшего драйвера NVIDIA.

Обновите драйвер видеокарты с официального сайта производителя. Если это не помогло, вероятно, установлена CPU-сборка PyTorch — её нужно переустановить с индексом CUDA по инструкции с официального сайта PyTorch, выбрав конфигурацию под вашу систему. Точные команды зависят от версии, поэтому копируйте их из официального установщика, а не из сторонних статей.

Часто задаваемые вопросы

Stable Diffusion запускается, но выдаёт ошибку при первой генерации. Что делать?

Откройте консоль и найдите последний блок Traceback — последняя строка укажет суть ошибки. Чаще всего это нехватка видеопамяти или недокачанная модель. Попробуйте сгенерировать изображение 512×512 с batch size 1.

Подойдёт ли видеокарта AMD для Stable Diffusion?

Да, но поддержка отличается. На Windows чаще используют сборки с DirectML, на Linux — ROCm. Производительность и совместимость зависят от конкретной карты и версии драйверов, поэтому сверяйтесь с документацией выбранного интерфейса.

Ошибка "git is not installed" при запуске установщика — как исправить?

Установите Git с официального сайта git-scm.com и при установке выберите опцию добавления в PATH. После этого перезапустите командную строку и повторите установку.

Можно ли запускать Stable Diffusion на карте с 4 ГБ видеопамяти?

Можно, с флагами --lowvram и --medvram, на разрешении 512×512. Генерация будет медленнее, и часть функций (например, обучение или крупные батчи) окажется недоступной.

После обновления веб-интерфейс перестал запускаться. Как откатиться?

Если установка выполнена через Git, можно вернуться к предыдущему коммиту командой git checkout с указанием хеша рабочей версии. Также проверьте расширения — именно они чаще всего ломаются после обновлений.