SQLite: no such table — таблица не найдена

#Что означает ошибка

Ошибка SQLite «no such table» означает, что запрос ссылается на таблицу, которой нет в открытом файле базы. Чаще всего приложение открыло другой файл (относительный путь, другая рабочая папка) или миграции не выполнены.

Проверьте, какой файл фактически открыт и какие таблицы в нём есть.

Многие случаи — это пустой файл, созданный автоматически при неверном пути.

Ошибка значит, что в открытой базе нет такой таблицы: открыт другой файл, миграции не выполнены, таблица названа иначе или база создалась пустой из-за неверного пути.

#Причины и решения

#Пошаговое решение

1. Проверьте путь и размер файлаОпределите, какую именно базу открывает приложение: посмотрите строку подключения в конфигурации, значение переменных окружения или путь, формируемый в коде. Запишите абсолютный путь, текущий каталог запуска и размер файла; относительный data.db зависит от того, где запущена служба. В Linux выполните ls -l /полный/путь/к/app.db; если файла нет, сначала проверьте, не создала ли библиотека SQLite новую пустую базу по неверному пути. Не создавайте таблицу в таком файле до сверки с рабочей базой.
2. Откройте базу в sqlite3В терминале на компьютере с правом читать базу выполните sqlite3 /полный/путь/к/app.db '.tables' — подставьте фактический путь; предварительно сделайте резервную копию или используйте режим чтения, чтобы не изменять базу случайно. Если отсутствует ожидаемая таблица, выполните .schema для просмотра схемы и убедитесь, что открыта верная версия базы. Помните: запуск sqlite3 с ошибочным путём может создать новую пустую базу, поэтому перед открытием проверьте наличие и размер файла.

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Список таблиц в базе.

   sqlite3 database.sqlite ".tables"

3. Сверьте имя таблицыСверьте имя таблицы из SQL с .tables и определением CREATE TABLE: при ошибке no such table: users запрос к user или временная таблица другого соединения не подходят. Учитывайте схему подключения ATTACH, виртуальные таблицы и таблицы из расширений — они могут существовать только в определённом соединении. Если у имени есть префикс, исправьте SQL на реальное имя и повторите запрос на тестовой копии; не переименовывайте работающие таблицы без проверки зависимостей.
4. Запустите миграцииЕсли это ожидаемая новая установка, выполните только официальные миграции своего проекта, предварительно сделав .backup и проверив версию схемы. Найдите в исходном проекте команду миграции и историю применённых изменений; в рабочем окружении запуск требует разрешения администратора и должен быть испытан на копии. Не копируйте произвольный CREATE TABLE из интернета: структура может иметь ключи, индексы, триггеры и связи, нужные приложению. После миграции повторите .tables и исходный SQL-запрос.
5. Проверьте права и окружениеЕсли таблица есть в одной среде, но отсутствует при запуске сайта/контейнера, посмотрите, под какой учётной записью работает процесс и где смонтирован том Docker. Сверьте путь внутри контейнера с файлом на хосте и проверьте журналы ошибок; разные окружения могут использовать разные пустые файлы SQLite. Учитывайте, что права доступа обычно дают ошибку unable to open database file/readonly, а не no such table. После исправления конфигурации повторите действие и проверьте, что запись/чтение идёт из нужной базы.

#Какой файл открыт

Открытие SQLite в режиме обычного чтения/записи по неверному пути может создать пустую базу. Сначала выясните реальный путь и проверьте существование файла, затем смотрите sqlite_schema и применённые миграции. realpath() в PHP возвращает false для отсутствующего файла; это диагностический признак, а не готовый способ восстановления.

#Содержимое

Откройте подтверждённый файл базы для просмотра схемы (sqlite3 /точный/путь/app.db ".tables"). Не запускайте самодельный php bin/migrate.php: команды миграций и их наличие зависят от проекта. При необходимости используйте штатный механизм после копии и проверки версии схемы.

#Права и среда

Проверьте права на каталог и файл: веб-сервер должен иметь право записи в каталог (для журналов). Для Docker смонтируйте том с файлом базы. На Windows и Linux различаются пути; проверьте, не подставляется ли тестовая база из переменной окружения. Не копируйте базу при работающем приложении без .backup.