// Referencia de errores de SQLite

SQLITE_CANTOPEN: No se puede abrir el archivo de base de datos

SQLite no pudo abrir el archivo de la base de datos o uno de sus archivos temporales: una ruta incorrecta, un directorio que no existe, un problema de permisos o una ruta que es un directorio.

Código de resultado
SQLITE_CANTOPEN
Nombre
14
Categoría
Códigos de resultado primarios
Mensaje de error
unable to open database file

Qué significa

SQLITE_CANTOPEN (14) significa que el sistema operativo se negó a abrir un archivo que SQLite necesitaba. Normalmente es el archivo principal de la base de datos, pero también puede ser un archivo temporal. SQLite crea un nuevo archivo de base de datos cuando la ruta no existe, así que este error suele indicar que falta el directorio o que no se puede escribir en él, no que falte el archivo.

Los códigos extendidos permiten afinar más, por ejemplo SQLITE_CANTOPEN_ISDIR (la ruta es un directorio) y SQLITE_CANTOPEN_FULLPATH (no se pudo resolver la ruta completa).

Causas comunes

  • El directorio en la ruta no existe; SQLite crea archivos, no directorios.
  • Una ruta relativa resuelta respecto a un directorio de trabajo inesperado, por ejemplo en un servicio o un ejecutor de pruebas.
  • No hay permiso para leer el archivo, o para crearlo en ese directorio.
  • La ruta apunta a un directorio (SQLITE_CANTOPEN_ISDIR).
  • El directorio temporal no existe o no se puede escribir en él, por lo que no se puede crear un archivo temporal.
  • Demasiados archivos abiertos en el proceso.

Cómo solucionarlo

  1. Usa una ruta absoluta y asegúrate de que exista cada directorio de la ruta.

  2. Revisa los permisos del archivo y de su directorio para el usuario con el que se ejecuta el programa.

  3. Si el problema son los archivos temporales, indica a SQLite un directorio con permisos de escritura mediante la SQLITE_TMPDIR o TMPDIR variable de entorno, o deja el almacenamiento temporal en memoria.

    PRAGMA temp_store = MEMORY;
  4. En el sqlite3 shell, confirma qué se abrió.

    .databases

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.