// Referencia de errores de SQLite

SQLITE_CORRUPT: La imagen de disco de la base de datos está dañada

SQLite detectó que la estructura del archivo de la base de datos está dañada. Deja de escribir en él, haz una copia y recupera lo que puedas con el comando .recover o desde una copia de seguridad.

Código de resultado
SQLITE_CORRUPT
Nombre
11
Categoría
Códigos de resultado primarios
Mensaje de error
database disk image is malformed

Qué significa

SQLITE_CORRUPT (11) significa que SQLite leyó del archivo algo que no encaja con su formato: una página dañada, un puntero inválido, una entrada de índice sin su fila correspondiente. En condiciones normales SQLite no corrompe archivos por su cuenta; la documentación de SQLite («Cómo corromper un archivo de base de datos SQLite») enumera lo que sí lo hace: copiar archivos con una transacción abierta, un bloqueo de archivos defectuoso (a menudo en sistemas de archivos de red), borrar un diario activo, fallos de hardware o de almacenamiento, y escrituras de otro código sobre el archivo.

SQLITE_CORRUPT_INDEX es un caso especial en el que solo está dañado un índice y REINDEX puede arreglarlo.

Causas comunes

  • Copiar el archivo de la base de datos o hacerle copia de seguridad mientras se estaba escribiendo, o copiarlo sin su -wal archivo.
  • Eliminar un -journal o -wal archivo que queda tras un fallo.
  • Un sistema de archivos de red o un volumen de contenedor con bloqueo poco confiable, que deja entrar a dos escritores a la vez.
  • Fallas de disco, memoria o energía, o una capa de almacenamiento que ignora fsync.
  • Otra parte del programa escribiendo en el archivo directamente a través de un descriptor de archivo abierto.

Cómo solucionarlo

  1. Deja de escribir en la base de datos y haz una copia del archivo y de cualquier -wal y -journal archivo antes de intentar nada.

  2. Mide el daño.

    PRAGMA integrity_check;
  3. Si solo los índices están afectados, reconstruyelos.

    REINDEX;
  4. De lo contrario, recupera los datos en un archivo nuevo con la sqlite3 shell's .recover comando y comprueba el resultado: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. Restaura desde una copia de seguridad si la recuperación está incompleta, y realiza futuras copias de seguridad con VACUUM INTO o la API de copia de seguridad en lugar de copiar el archivo mientras está en uso.

    VACUUM INTO '/backups/app-2026-11-09.db';

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.