// Referencia de errores de SQLite

SQLITE_BUSY_RECOVERY: Otro proceso está recuperando el WAL

Otro proceso está recuperando una base de datos en modo WAL después de un fallo, por lo que esta conexión tiene que esperar. Se libera una vez que la recuperación termina.

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

Qué significa

SQLITE_BUSY_RECOVERY (261) es un extendido SQLITE_BUSY código para bases de datos en modo WAL: una operación no pudo continuar porque otro proceso está ocupado recuperando el archivo de la base de datos tras un fallo. La recuperación reconstruye el índice WAL a partir del archivo WAL y normalmente tarda un momento.

Causas comunes

  • Un proceso que usa la base de datos se bloqueó o fue terminado, y la siguiente conexión está recuperando el WAL.
  • Un archivo WAL muy grande, lo que hace que la recuperación tarde más.

Cómo solucionarlo

  1. Inténtalo de nuevo tras una breve espera, o configura un tiempo de espera por ocupado (busy timeout) para que SQLite espere por ti.

    PRAGMA busy_timeout = 5000;
  2. Mantén el WAL pequeño con puntos de control regulares, para que la recuperación tras un fallo sea rápida.

    PRAGMA wal_checkpoint(TRUNCATE);

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.