Ошибка Error code 1 в Stable Diffusion (чаще всего в веб-интерфейсе Automatic1111) появляется, когда Python-процесс завершается с кодом возврата 1 — это универсальный сигнал о том, что скрипт упал с необработанной ошибкой ещё до загрузки интерфейса. Само по себе сообщение «exited with code 1» не говорит о причине: ключ к диагностике находится в строках выше, в тексте traceback, который выводится в консоль перед завершением.
Такой сбой возникает при запуске через webui-user.bat или webui.sh, при установке расширений, после обновления или при первом старте свежей копии. Ниже разберём типичные причины и безопасные способы их устранения, не прибегая к переустановке всей системы.
Что означает Error Code 1 в Stable Diffusion
Код возврата 1 — стандартный ответ интерпретатора Python при аварийном завершении программы. В контексте Stable Diffusion это значит, что скрипт launch.py или один из модулей веб-интерфейса выбросил исключение, и процесс остановился. Интерфейс при этом не открывается, а окно консоли либо закрывается, либо «замирает» на строке с ошибкой.
Причина всегда указана в тексте исключения над строкой с кодом завершения. Это может быть ModuleNotFoundError, RuntimeError, ошибка загрузки модели или сбой при обращении к git-репозиторию. Поэтому первый шаг диагностики — не гадать, а внимательно прочитать лог.
Как прочитать лог ошибки
Запустите веб-интерфейс через командную строку, чтобы окно не закрывалось автоматически. Откройте терминал в папке stable-diffusion-webui и выполните запуск вручную:
cd путь\к\stable-diffusion-webui
webui-user.bat
После падения процесса прокрутите вывод вверх и найдите блок, начинающийся со строки Traceback (most recent call last). Последняя строка этого блока — тип и текст исключения, именно по ней строится дальнейшая диагностика.
- 🔍 ModuleNotFoundError: No module named... — не хватает Python-пакета, обычно после обновления или установки расширения.
- 🧩 RuntimeError с упоминанием CUDA или torch — проблема с драйвером видеокарты или версией PyTorch.
- 📦 GitCommandError — сбой при клонировании или обновлении репозиториев зависимостей.
- 💾 Упоминание checkpoint или .safetensors — повреждённый или недокачанный файл модели.
Типичные причины и их устранение
Чаще всего виновником оказывается неподходящая версия Python. Automatic1111 рассчитан на Python 3.10.x; установка более новой ветки (например, 3.12) нередко приводит к несовместимости зависимостей и падению на этапе импорта. Проверьте версию командой python --version — если она отличается, установите подходящую с официального сайта Python и при установке отметьте добавление в PATH.
Вторая частая причина — повреждённое виртуальное окружение venv. Оно создаётся при первом запуске, и прерванная установка пакетов (обрыв сети, закрытие окна) оставляет его в нерабочем состоянии. Безопасное решение — удалить папку venv внутри каталога веб-интерфейса и запустить webui-user.bat заново: окружение будет пересоздано автоматически.
⚠️ Внимание: перед удалением папки venv убедитесь, что у вас стабильное интернет-соединение — пересоздание окружения требует загрузки пакетов, и обрыв на середине снова приведёт к той же ошибке.
Проблемы с видеокартой и PyTorch
Если в логе фигурируют CUDA, torch или сообщения о невозможности выделить память, источник — связка «драйвер GPU + PyTorch». Обновите драйвер видеокарты с официального сайта производителя (NVIDIA или AMD), затем перезапустите веб-интерфейс. Устаревший драйвер — одна из самых частых причин падений на этапе инициализации torch.
На системах с малым объёмом видеопамяти помогает запуск с параметрами экономии VRAM. Откройте файл webui-user.bat в текстовом редакторе и добавьте в строку COMMANDLINE_ARGS соответствующие флаги, например:
set COMMANDLINE_ARGS=--medvram --xformersДля совсем слабых карт вместо --medvram используется --lowvram. Если GPU нет или он не поддерживается, возможен запуск на процессоре с флагом --use-cpu all, но генерация будет очень медленной — это скорее способ проверить работоспособность установки, чем рабочий режим.
Конфликты расширений и повреждённые модели
Если ошибка появилась сразу после установки нового расширения, почти наверняка виновато оно. Расширения подключают собственные зависимости и могут ломать запуск всего интерфейса. Проверка проста: временно переименуйте папку extensions (или удалите из неё последнее добавленное дополнение) и запустите веб-интерфейс снова.
Отдельный сценарий — повреждённый файл модели в папке models/Stable-diffusion. Недокачанный чекпоинт вызывает падение при загрузке. Убедитесь, что размер файла соответствует указанному на странице скачивания, а при сомнениях переместите модель из папки и проверьте запуск без неё.
☑️ Базовая диагностика Error Code 1
Чистая переустановка как крайняя мера
Когда ничто из перечисленного не помогает, остаётся полная переустановка. Удалите папку stable-diffusion-webui целиком (предварительно скопировав в безопасное место ваши модели из models и сгенерированные изображения из outputs), затем клонируйте репозиторий заново через Git:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.gitДля клонирования в системе должен быть установлен Git — его отсутствие, кстати, само по себе является причиной падений с кодом 1 на этапе загрузки зависимостей. Проверить наличие можно командой git --version.
⚠️ Внимание: при переустановке не копируйте старую папку venv и старые расширения в свежую установку «для экономии времени» — так вы перенесёте и первоначальную проблему.
Почему ошибка возникает после обновления
Обновление через git pull подтягивает новый код интерфейса, но зависимости в venv остаются старыми. Возникает рассинхронизация версий пакетов, и запуск падает. Лечение стандартное: удаление venv и повторный запуск, чтобы установщик подтянул актуальные версии пакетов под новый код.
Сводная таблица причин и решений
| Симптом в логе | Вероятная причина | Действие |
|---|---|---|
| ModuleNotFoundError | Битое окружение venv | Удалить venv, перезапустить |
| RuntimeError + CUDA | Драйвер или PyTorch | Обновить драйвер GPU |
| GitCommandError | Нет Git или сбой сети | Установить Git, проверить интернет |
| Ошибка после установки расширения | Конфликт дополнения | Удалить расширение из extensions |
| Ошибка загрузки checkpoint | Повреждённый файл модели | Скачать модель заново |
Эта таблица покрывает наиболее распространённые сценарии, но не исчерпывает всех: текст исключения в вашем конкретном логе — единственный достоверный источник диагностики, и ориентироваться нужно прежде всего на него.
Часто задаваемые вопросы
Error code 1 появляется сразу при первом запуске. Что делать?
Проверьте три вещи: установлен ли Python версии 3.10.x и добавлен ли он в PATH, установлен ли Git, не блокирует ли антивирус или брандмауэр загрузку пакетов. Затем удалите папку venv, если она успела создаться, и запустите webui-user.bat повторно.
Ошибка пропала после удаления расширения. Как вернуть его?
Установите расширение заново через вкладку Extensions интерфейса. Если падение повторится, дополнение несовместимо с вашей версией веб-интерфейса — проверьте страницу расширения на предмет известных проблем или требований к версии.
Поможет ли обновление драйвера, если в логе нет упоминаний CUDA?
Если traceback не касается torch, CUDA или памяти, драйвер, скорее всего, ни при чём. Ориентируйтесь на текст исключения: обновление драйвера оправдано только при ошибках инициализации GPU.
Можно ли запустить Stable Diffusion без видеокарты?
Да, с флагом --use-cpu all в COMMANDLINE_ARGS интерфейс запустится на процессоре. Это подходит для проверки работоспособности установки, но генерация изображений будет занимать значительно больше времени, чем на GPU.
После обновления через git pull всё сломалось. Как откатиться?
Удалите папку venv и запустите интерфейс заново — чаще всего проблема в рассинхронизации зависимостей. Если не помогло, можно откатить код репозитория на предыдущий коммит средствами Git либо выполнить чистую переустановку с сохранением папок models и outputs.