SQLITE_BUSY: ожидание блокировки требует отдельного бюджета времени

Запросить

Busy timeout задаёт обработчик ожидания занятости SQLite connection. Он может несколько раз ждать освобождения блокировки, после чего операция возвращает SQLITE_BUSY. Наличие тайм-аута не означает гарантированного успеха записи и не создаёт дополнительного параллельного писателя для той же базы.

Ожидание SQLITE_BUSY
Busy timeout ограничивает ожидание, но не гарантирует успешную запись. При риске взаимной блокировки BUSY может вернуться без вызова обработчика; прикладные повторы имеют общий срок.

SQLite может вернуть BUSY без вызова обработчика, если ожидание способно привести к взаимной блокировке. Поэтому фактическая задержка не обязана всегда совпадать с настроенным временем. Немедленный отказ нельзя автоматически считать признаком проигнорированной конфигурации; сначала устанавливают тип операции и удерживаемые другими connection блокировки.

На одном connection действует один busy-handler. Установка busy_timeout заменяет ранее назначенный обработчик. Это важно при сочетании библиотечного слоя и прикладного кода: каждый может считать своё правило активным. Повторные попытки приложения тоже ограничивают общим сроком и связывают с фактическим состоянием транзакции.

В приёмке проверяют краткую занятость, длительную блокировку и согласованный конфликт повышения блокировки. Сохраняют результат и время ожидания. Перезапуск службы или бесконечный повтор одной записи не является доказательством исправления: требуется предсказуемая реакция на исчерпанный бюджет и сохранность входящих данных.

Основание — SQLite official unversioned documentation snapshot; Download index observed 3.54.1, individual pages not version-tagged, разделы Busy timeout; Lock contention and deadlock avoidance. Сохранён текст публичной справочной публикации; конкретная реализация может поддерживать только часть возможностей. Установленная библиотека, сборка, файловая система и база узла не проверялись. Это проектный сценарий; SQL и сервисные операции на реальных данных не выполнялись.

Все разборы