// справочник ошибок SQLite

SQLITE_CANTOPEN: невозможно открыть файл базы данных

SQLite не удалось открыть файл базы данных или один из его временных файлов: неверный путь, отсутствующая директория, проблема с правами доступа или путь, который является директорией.

Код результата
SQLITE_CANTOPEN
Имя
14
Категория
Основные коды результатов
Сообщение об ошибке
unable to open database file

Что это значит

SQLITE_CANTOPEN (14) означает, что операционная система отказалась открыть файл, необходимый SQLite. Обычно это основной файл базы данных, но это также может быть временный файл. SQLite создаёт новый файл базы данных, если путь не существует, поэтому эта ошибка обычно означает, что каталог отсутствует или недоступен для записи, а не то, что файл отсутствует.

Расширенные коды уточняют причину, например SQLITE_CANTOPEN_ISDIR (путь является каталогом) и SQLITE_CANTOPEN_FULLPATH (не удалось разрешить полный путь).

Распространённые причины

  • Каталог в пути не существует; SQLite создаёт файлы, а не каталоги.
  • Относительный путь разрешается относительно неожиданного рабочего каталога, например, в службе или тест-раннере.
  • Нет разрешения на чтение файла или на его создание в этой директории.
  • Путь указывает на директорию (SQLITE_CANTOPEN_ISDIR).
  • Временный каталог отсутствует или недоступен для записи, поэтому временный файл не создаётся.
  • Слишком много открытых файлов в процессе.

Как исправить

  1. Используйте абсолютный путь и убедитесь, что каждая директория в нём существует.

  2. Проверьте разрешения на файл и его директорию для пользователя, от имени которого выполняется программа.

  3. Если проблема во временных файлах, направьте SQLite в доступную для записи директорию с помощью SQLITE_TMPDIR или TMPDIR переменную окружения, или храните временные данные в памяти.

    PRAGMA temp_store = MEMORY;
  4. В sqlite3 оболочке подтвердите, что открылось.

    .databases

Связанные ошибки

Больше ошибок основных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQLite в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.