// Referência de erro do SQLite

SQLITE_BUSY_TIMEOUT: o bloqueio de arquivo em espera expirou

Uma solicitação de travamento de arquivo POSIX em modo bloqueante na camada VFS do SQLite expirou. Só builds compiladas com SQLITE_ENABLE_SETLK_TIMEOUT retornam esse erro.

Código de resultado
SQLITE_BUSY_TIMEOUT
Nome
773
Categoria
Códigos de resultado estendidos
Mensagem de erro
database is locked

O que significa

A documentação do SQLite descreve SQLITE_BUSY_TIMEOUT (773) como uma solicitação de bloqueio de arquivo consultivo (advisory) POSIX bloqueante que falhou devido a um tempo limite. Bloqueios bloqueantes só são usados quando o SQLite é compilado com SQLITE_ENABLE_SETLK_TIMEOUT, então a maioria dos aplicativos nunca vê esse código; eles recebem apenas SQLITE_BUSY quando um bloqueio não pode ser obtido.

Causas comuns

  • Outra conexão manteve o bloqueio por mais tempo do que o tempo de espera configurado, em uma build que usa bloqueios bloqueantes.

Como corrigir

  1. Trate-o como SQLITE_BUSY: mantenha as transações de escrita curtas, use o modo WAL e tente novamente.

  2. Aumente o tempo de espera se for esperado que quem detém o bloqueio demore.

    PRAGMA busy_timeout = 10000;

Erros relacionados

Mais erros de códigos de resultado estendidos

O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQLite no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQLite e os outros bancos de dados que você usa.