Остановите повторные попытки обновления над единственным пользовательским профилем. Сначала сохраните корректную копию базы поддерживаемым способом и установите версии приложения и схемы. Для desktop-системы миграция часто выполняется при первом запуске у каждого пользователя, поэтому успешная установка файлов ещё не подтверждает обновление данных.
Профиль пользователя проходит собственный релиз
| Состояние | Что требуется от приложения |
|---|---|
| Старая схема | Выполнить предусмотренный переход |
| Новая поддерживаемая схема | Открыть без повторной миграции |
| Схема новее кода | Отказаться от несовместимой записи |
| Переход прерван | Продолжить или восстановить по плану |
| Нет места для копии | Остановиться до разрушительных действий |
Не подменяйте версию схемы версией установленной программы. Один и тот же бинарник может встретить профиль, не открывавшийся несколько выпусков. Миграции должны иметь определённый маршрут от каждой поддерживаемой старой схемы, а неподдерживаемое состояние — понятное сообщение без сброса данных.
Условный паспорт перехода:
profile_id -> обезличенный профиль
app_version -> запускаемый код
schema_before -> подтверждённая версия
migration_id -> конкретный переход
backup_identity -> проверенная копия
schema_after -> версия после успешного перехода
result -> завершён / откатан / требует восстановленияКопия должна учитывать способ работы базы
SQLite предоставляет Online Backup API для согласованного снимка работающей базы. Документация проверена 27 октября 2026 года. Не заменяйте это случайным копированием одного файла во время записи: при WAL-режиме и незавершённых операциях такая процедура требует понимания полного состояния. Используйте механизм вашей библиотеки и проверяйте открытие копии.
Храните резервную копию отдельно от пути, который установщик может очистить. Перед миграцией подтвердите доступность места и прав в реальном пользовательском контексте. Профиль тестового администратора не воспроизводит ограничения обычного пользователя или переносной установки.
PRAGMA user_version в SQLite предназначена для значения, которым управляет приложение; SQLite не интерпретирует её как автоматический механизм миграции. Источник проверен 27 октября 2026 года. Если выбран этот способ учёта схемы, обновляйте маркер только по согласованному правилу после успешного перехода.
Используйте транзакцию там, где операции и библиотека позволяют сделать переход атомарным. Для внешних файлов и других нетранзакционных шагов нужен отдельный план восстановления. Нельзя объявлять весь переход откатываемым только потому, что один SQL-шаг находится внутри транзакции.
Повторный запуск обязан понимать прерывание
- Скопировать разрешённый тестовый профиль старой версии.
- Выполнить штатный первый запуск новой сборки.
- Проверить записи, связи и пользовательские действия.
- Прервать тестовый переход в выбранной контролируемой точке.
- Повторить запуск и проверить предусмотренное восстановление.
Заблокируйте конкурирующую миграцию одного профиля. Два процесса, открывшие приложение одновременно, не должны независимо решить, что им обоим пора менять схему. Владение переходом и состояние ожидания должны быть определены до начала изменения данных.
Возврат старого установщика не возвращает прежнюю базу. Если downgrade поддерживается, заранее определите совместимость схемы или процедуру восстановления копии с учётом новых записей. Простое восстановление вчерашнего файла может удалить действия пользователя после обновления.
Приёмка включает старый профиль, пропущенные версии, повтор после сбоя и отказ при более новой схеме. Для диагностики сохраните миграцию, версии и обезличенный результат проверок целостности. Пользователь должен получить рабочие данные или объяснимый безопасный отказ, а не молчаливо созданную пустую базу.