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

SQLITE_BUSY_TIMEOUT: истекло время ожидания файловой блокировки

Истекло время ожидания блокирующего запроса на POSIX-блокировку файла в VFS-слое SQLite. Возникает только в сборках, скомпилированных с SQLITE_ENABLE_SETLK_TIMEOUT.

Код результата
SQLITE_BUSY_TIMEOUT
Имя
773
Категория
Расширенные коды результатов
Сообщение об ошибке
database is locked

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

Документация SQLite описывает SQLITE_BUSY_TIMEOUT (773) как блокирующий запрос рекомендательной блокировки POSIX, завершившийся из-за тайм-аута. Блокирующие запросы используются, только когда SQLite скомпилирован с SQLITE_ENABLE_SETLK_TIMEOUT, поэтому большинство приложений никогда не видят этот код; они получают обычное SQLITE_BUSY когда блокировку не удаётся получить.

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

  • Другое соединение удерживало блокировку дольше настроенного времени ожидания (в сборке с блокирующими блокировками).

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

  1. Обрабатывайте это как SQLITE_BUSY: держите транзакции записи короткими, используйте режим WAL и повторяйте попытки.

  2. Увеличьте время ожидания, если держатель блокировки, вероятно, будет занят долго.

    PRAGMA busy_timeout = 10000;

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

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

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

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

Работа с SQLite в SQLly

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