// справочник ошибок SQLite

SQLITE_CORRUPT: образ диска базы данных повреждён

SQLite обнаружил повреждение структуры файла базы данных. Прекратите запись в него, сделайте копию и восстановите всё, что можно, с помощью команды .recover или из резервной копии.

Код результата
SQLITE_CORRUPT
Имя
11
Категория
Основные коды результатов
Сообщение об ошибке
database disk image is malformed

Что это значит

SQLITE_CORRUPT (11) означает, что SQLite прочитал в файле данные, не соответствующие его формату: повреждённую страницу, неверный указатель, запись индекса без соответствующей строки. Сам по себе SQLite в обычной работе файлы не повреждает; документация SQLite («How To Corrupt An SQLite Database File») перечисляет, что может их повредить: копирование файлов при открытой транзакции, сломанную блокировку файлов (обычно в сетевых файловых системах), удаление горячего журнала, сбои оборудования или хранилища и запись в файл со стороны другого кода.

SQLITE_CORRUPT_INDEX это особый случай, когда поврежден только индекс, и REINDEX может это исправить.

Распространённые причины

  • Копирование или резервное копирование файла базы данных во время записи в него, или копирование без его -wal файл.
  • Удаление -journal или -wal файл, оставшийся после сбоя.
  • Сетевая файловая система или контейнерный том с ненадёжной блокировкой, которая впускает два процесса записи одновременно.
  • Сбои диска, памяти или питания, а также слой хранения, который игнорирует fsync.
  • Другая часть программы записывает в файл напрямую через открытый файловый дескриптор.

Как исправить

  1. Прекратите запись в базу данных и сделайте копию файла и всего -wal и -journal файлы, прежде чем вы что-либо попробуете.

  2. Оцените ущерб.

    PRAGMA integrity_check;
  3. Если затронуты только индексы, пересоздайте их.

    REINDEX;
  4. В противном случае восстановите данные в новый файл с sqlite3 оболочки .recover команду, затем проверьте результат: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. Восстановите из резервной копии, если восстановление было неполным, и делайте будущие резервные копии с помощью VACUUM INTO или API резервного копирования вместо копирования файла, пока тот используется.

    VACUUM INTO '/backups/app-2026-11-09.db';

Связанные ошибки

Больше ошибок основных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQLite в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.