[migrations, low] -migrate: ошибки FK (errno 150) глотаются, verify не выполняется — сломанная миграция пишется как применённая #3

Closed
opened 2026-10-26 10:24:09 +03:00 by mchus · 0 comments
Owner

Контекст

qfs -migrate запускает только разработчик, один раз и вручную. У клиентов миграции не выполняются, поэтому требования go-database к бэкапу, откату и восстановлению к этому инструменту не относятся. Ниже то, что может незаметно подвести при ручном запуске: сломанная миграция записывается в qt_schema_migrations как применённая, а повторный запуск её уже пропускает.

Что стоит поправить (дёшево)

  1. Ошибки FK глотаются. В isIgnorableMigrationError (internal/models/sql_migrations.go:232-247) есть "can't create table" и "errno 121". В MariaDB под Can't create table … (errno: 150 "Foreign key constraint is incorrectly formed") приходит провал добавления FK, и раннер помечает такую миграцию применённой. Безопасно игнорировать только duplicate column/key name и already exists.
  2. -- verify: не выполняется. Заголовки есть во всех файлах, но раннер пропускает строки с --. Достаточно выполнить их после файла и не делать запись в qt_schema_migrations, если запрос вернул строку. Тогда сразу видно, что миграция не применилась.
  3. Одна сессия. Миграции 007 и 010 используют сессионные переменные (SET @…), а стейтменты идут через пул GORM. Выполнять файл через db.Connection(func(tx *gorm.DB) error {…}), это одна строка.

Не требуется

  • Бэкап и откат перед миграцией: разработчик делает это сам, если нужно.
  • Сплиттер с учётом литералов: в текущих файлах ; внутри строк нет. Достаточно помнить об этом при написании новых миграций.
## Контекст `qfs -migrate` запускает только разработчик, один раз и вручную. У клиентов миграции не выполняются, поэтому требования `go-database` к бэкапу, откату и восстановлению к этому инструменту **не относятся**. Ниже то, что может незаметно подвести при ручном запуске: сломанная миграция записывается в `qt_schema_migrations` как применённая, а повторный запуск её уже пропускает. ## Что стоит поправить (дёшево) 1. **Ошибки FK глотаются.** В `isIgnorableMigrationError` (`internal/models/sql_migrations.go:232-247`) есть `"can't create table"` и `"errno 121"`. В MariaDB под `Can't create table … (errno: 150 "Foreign key constraint is incorrectly formed")` приходит провал добавления FK, и раннер помечает такую миграцию применённой. Безопасно игнорировать только `duplicate column/key name` и `already exists`. 2. **`-- verify:` не выполняется.** Заголовки есть во всех файлах, но раннер пропускает строки с `--`. Достаточно выполнить их после файла и не делать запись в `qt_schema_migrations`, если запрос вернул строку. Тогда сразу видно, что миграция не применилась. 3. **Одна сессия.** Миграции `007` и `010` используют сессионные переменные (`SET @…`), а стейтменты идут через пул GORM. Выполнять файл через `db.Connection(func(tx *gorm.DB) error {…})`, это одна строка. ## Не требуется - Бэкап и откат перед миграцией: разработчик делает это сам, если нужно. - Сплиттер с учётом литералов: в текущих файлах `;` внутри строк нет. Достаточно помнить об этом при написании новых миграций.
mchus changed title from [migrations] -migrate не выполняет verify-проверки, игнорирует ошибки FK и ломает сессионные переменные to [migrations, low] -migrate: ошибки FK (errno 150) глотаются, verify не выполняется — сломанная миграция пишется как применённая 2026-10-26 10:26:38 +03:00
mchus closed this issue 2026-10-26 22:49:55 +03:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mchus/QuoteForge#3