// Referencia de errores de SQLite

SQLITE_READONLY: Intento de escribir en una base de datos de solo lectura

La conexión no puede escribir: el archivo o su directorio no son escribibles, la base de datos se abrió en modo solo lectura, o SQLite no puede crear su archivo de diario.

Código de resultado
SQLITE_READONLY
Nombre
8
Categoría
Códigos de resultado primarios
Mensaje de error
attempt to write a readonly database

Qué significa

SQLITE_READONLY (8) se devuelve cuando una instrucción intenta cambiar datos para los que la conexión no tiene permiso de escritura. Escribir exige permiso sobre el archivo de la base de datos y también sobre su directorio, porque SQLite crea un diario (-journal) o WAL (-wal, -shm) junto a él.

Los códigos extendidos indican la razón: SQLITE_READONLY_DIRECTORY (sin permiso para crear el diario), SQLITE_READONLY_DBMOVED (el archivo se movió o se eliminó mientras estaba abierto), SQLITE_READONLY_ROLLBACK (un diario activo necesita revertirse pero la base de datos es de solo lectura), y otros.

Causas comunes

  • El archivo de la base de datos es propiedad de otro usuario o está montado como solo lectura, típico para un usuario de servidor web o un archivo dentro de un paquete de aplicación.
  • El directorio no es escribible, así que SQLite no puede crear el archivo de diario, aunque el archivo en sí sí lo sea.
  • La conexión se abrió como solo lectura (SQLITE_OPEN_READONLY, ?mode=ro URI, o PRAGMA query_only = ON).
  • El archivo se movió, renombró o eliminó mientras la conexión estaba abierta (SQLITE_READONLY_DBMOVED).

Cómo solucionarlo

  1. Otorga al proceso permiso de escritura sobre el archivo y su directorio. En Linux y macOS verifica con ls -l en ambos, y luego corrige la propiedad o el modo.

  2. Verifica si la conexión en sí es de solo lectura.

    PRAGMA query_only;
    PRAGMA database_list;
  3. Abre la base de datos en modo lectura-escritura: drop mode=ro de la URI o del flag de solo lectura de la llamada de apertura.

  4. Si el archivo se movió mientras estaba abierto, cierra la conexión y ábrela de nuevo en su nueva ruta.

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.