STRUCTUREцифровые системыОбсудить проект
НОВОСТЬ · Engineering

Линтер миграций Django ошибся в 405 случаях из 407: автор объяснил причины

Разработчик открытого инструмента orm-lens проверил миграции крупных Django-проектов и обнаружил, что почти все первоначальные критические предупреждения были ложными. Разбор показал, почему анализатору недостаточно изучать отдельные операции без контекста всей цепочки миграций.

Главное

Автор orm-lens рассказал о проверке миграций нескольких популярных открытых проектов, включая NetBox, PostHog, authentik, Plane и paperless-ngx. Его анализатор обозначил 407 потенциально критических операций, однако ручной разбор оставил лишь две действительно обоснованные находки. Это результаты конкретного тестирования самого инструмента, а не свидетельство того, что в перечисленных системах произошло столько же сбоев на работающих серверах.

Одна из основных причин шума связана с тем, как Django создаёт схему базы. Например, добавление текстового поля с blank=True не всегда требует явно заданного default: механизм миграций способен подставлять пустую строку. Поля отношений многие-ко-многим не обязательно добавляют столбец в существующую таблицу, а создают отдельную структуру связей. Анализатор, который трактует каждую операцию AddField одинаково, неизбежно сообщает о рисках, которых в конкретном сценарии нет.

Подробности

Дополнительные ошибки возникали при чтении сжатых миграций и зависимостей между файлами. Squash-миграция может заменять цепочку предшествующих изменений, а автогенератор Django способен сначала создать пустую таблицу и затем добавить внешний ключ в рамках того же перехода. Если проигнорировать последовательность операций, добавление обязательного поля будет выглядеть опасным, хотя реальных строк в только что созданной таблице ещё нет.

Две оставшиеся находки автор связывает с миграцией PostHog, где удаляются и затем снова добавляются обязательные внешние ключи. Такая последовательность может быть проблемой для таблицы с уже существующими данными. Но важная оговорка сохраняется: само статическое обнаружение не доказывает, что конкретное производственное обновление упало. Анализатор не знает содержимое базы на момент выполнения, поэтому должен различать проверяемый риск и подтверждённый инцидент.

Что это меняет

После разбора разработчик скорректировал правила и обратился к другой задаче — поиску запросов N+1 при обходе Django QuerySet. Там тоже встречались ложные совпадения, поэтому результаты разделяются по уровню уверенности. Практический вывод для команд, использующих статический анализ в CI, состоит в необходимости проверять сигналы на реальных кодовых базах, учитывать последовательность изменений и явно показывать случаи, которые невозможно уверенно доказать без запуска миграции.

Первоисточник

Материал подготовлен STRUCTURE по открытой публикации Habr. Текст и иллюстрации первоисточника не воспроизводятся целиком.

Читать исходную новость целиком ↗