// Referencia de errores de SQLite

SQLITE_PROTOCOL: Protocolo de bloqueo

En modo WAL, una conexión perdió la carrera por iniciar una transacción muchas veces durante varios segundos y se dio por vencida. Muy raro; señal de alta contención de escritura.

Código de resultado
SQLITE_PROTOCOL
Nombre
15
Categoría
Códigos de resultado primarios
Mensaje de error
locking protocol

Qué significa

La documentación de SQLite describe SQLITE_PROTOCOL (15) como un problema del protocolo de bloqueo de archivos; por ahora solo se devuelve en modo WAL al iniciar una transacción. Cuando dos conexiones compiten por iniciar una transacción, la que pierde se retira y reintenta; si la misma conexión pierde una y otra vez durante varios segundos, devuelve SQLITE_PROTOCOL. Debería aparecer solo cuando muchos procesos compiten con fuerza por escribir en la misma base de datos.

Causas comunes

  • Muchos procesos escribiendo a la vez en la misma base de datos en modo WAL.
  • Bloqueo de archivos que funciona mal, por ejemplo en un sistema de archivos de red.

Cómo solucionarlo

  1. Reduce el número de escritores concurrentes; por ejemplo, canaliza las escrituras a través de un proceso o una cola.

  2. Mantén la base de datos en un disco local con bloqueos que funcionen.

  3. Trátalo como SQLITE_BUSY: reintenta la transacción después de una pequeña pausa.

Errores relacionados

Más errores de códigos de resultado principales

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.