qfs -migrate запускает только разработчик, один раз и вручную. У клиентов миграции не выполняются, поэтому требования go-database к бэкапу, откату и восстановлению к этому инструменту не относятся. Ниже то, что может незаметно подвести при ручном запуске: сломанная миграция записывается в qt_schema_migrations как применённая, а повторный запуск её уже пропускает.
Что стоит поправить (дёшево)
Ошибки 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.
-- verify: не выполняется. Заголовки есть во всех файлах, но раннер пропускает строки с --. Достаточно выполнить их после файла и не делать запись в qt_schema_migrations, если запрос вернул строку. Тогда сразу видно, что миграция не применилась.
Одна сессия. Миграции 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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Контекст
qfs -migrateзапускает только разработчик, один раз и вручную. У клиентов миграции не выполняются, поэтому требованияgo-databaseк бэкапу, откату и восстановлению к этому инструменту не относятся. Ниже то, что может незаметно подвести при ручном запуске: сломанная миграция записывается вqt_schema_migrationsкак применённая, а повторный запуск её уже пропускает.Что стоит поправить (дёшево)
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.-- verify:не выполняется. Заголовки есть во всех файлах, но раннер пропускает строки с--. Достаточно выполнить их после файла и не делать запись вqt_schema_migrations, если запрос вернул строку. Тогда сразу видно, что миграция не применилась.007и010используют сессионные переменные (SET @…), а стейтменты идут через пул GORM. Выполнять файл черезdb.Connection(func(tx *gorm.DB) error {…}), это одна строка.Не требуется
;внутри строк нет. Достаточно помнить об этом при написании новых миграций.[migrations] -migrate не выполняет verify-проверки, игнорирует ошибки FK и ломает сессионные переменныеto [migrations, low] -migrate: ошибки FK (errno 150) глотаются, verify не выполняется — сломанная миграция пишется как применённая