// Referencia de errores de SQLite

SQLITE_BUSY_TIMEOUT: Tiempo de espera de bloqueo de archivo agotado

Una solicitud de bloqueo de archivo POSIX en la capa VFS de SQLite agotó el tiempo de espera. Solo la devuelven las compilaciones hechas con SQLITE_ENABLE_SETLK_TIMEOUT.

Código de resultado
SQLITE_BUSY_TIMEOUT
Nombre
773
Categoría
Códigos de resultado extendidos
Mensaje de error
database is locked

Qué significa

La documentación de SQLite describe SQLITE_BUSY_TIMEOUT (773) como una solicitud de bloqueo de archivo consultivo POSIX en modo bloqueante que agotó el tiempo de espera. Los bloqueos bloqueantes solo se usan cuando SQLite se compila con SQLITE_ENABLE_SETLK_TIMEOUT, por lo que la mayoría de las aplicaciones nunca ven este código; obtienen simplemente SQLITE_BUSY cuando no se puede adquirir un bloqueo.

Causas comunes

  • Otra conexión mantuvo el bloqueo más tiempo de lo configurado, en una compilación que usa bloqueos bloqueantes.

Cómo solucionarlo

  1. Trátalo como SQLITE_BUSY: mantén las transacciones de escritura cortas, usa el modo WAL y reintenta.

  2. Aumenta el tiempo de espera si quien tiene el bloqueo va a tardar.

    PRAGMA busy_timeout = 10000;

Errores relacionados

Más errores de códigos de resultado extendidos

El código y el texto del mensaje son de Documentación de los códigos de resultado y de error de SQLite. Explora la lista completa de Lista de errores de SQLite o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con SQLite en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQLite y las demás bases de datos que uses.