// Referencia de errores de SQLite

SQLITE_IOERR: Error de E/S de disco

El sistema operativo notificó un error de E/S mientras SQLite leía, escribía, sincronizaba o bloqueaba un archivo. El código extendido indica qué operación falló.

Código de resultado
SQLITE_IOERR
Nombre
10
Categoría
Códigos de resultado primarios
Mensaje de error
disk I/O error

Qué significa

SQLITE_IOERR (10) significa que una operación de archivo falló a nivel del sistema operativo. SQLite tiene muchos códigos extendidos para este caso, como SQLITE_IOERR_READ, SQLITE_IOERR_WRITE, SQLITE_IOERR_FSYNC, SQLITE_IOERR_SHORT_READ (menos bytes de los solicitados, por ejemplo, un archivo truncado) y SQLITE_IOERR_LOCK. Un disco lleno normalmente da SQLITE_FULL en su lugar.

El código extendido es la mejor pista: habilita los códigos de resultado extendidos o léelos con sqlite3_extended_errcode().

Causas comunes

  • Almacenamiento fallido o desconectado: un USB retirado, un recurso compartido de red no montado, un disco dañado.
  • Un sistema de archivos de red o carpeta de sincronización que no soporta el bloqueo o la sincronización que SQLite necesita.
  • Software antivirus o de copia de seguridad que mantiene o cambia el archivo.
  • El archivo se truncó o se reemplazó mientras había una conexión abierta.

Cómo solucionarlo

  1. Lee el código ampliado para ver qué operación falló y revisa los registros del sistema operativo en busca de errores de disco.

  2. Mantén la base de datos en un disco local. Si tienes que compartirla, no compartas el archivo: pon un servidor delante.

  3. Excluye la base de datos, -journal, -wal y -shm archivos de los análisis de antivirus y de las herramientas de sincronización de archivos.

  4. Después de cualquier error de E/S, revisa el archivo antes de confiar en él.

    PRAGMA integrity_check;

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.