Files
mtusi2026lab2/evidence/migrations/migration-error.md
T
ricoromaandClaude Opus 5.5 484914c38a docs: add evidence for postgres-storage verify fixes
- statement timeout: 503 and no SQL parameters in logs, before and after
- failed migration keeps the API from starting
- fresh clone: console from zero, then docker and make down
- restart evidence with docker compose ps

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 16:47:42 +03:00

3.2 KiB
Raw Blame History

Ошибка миграции: API не стартует, ошибка в журнале migrate

Спек db-migrations «Ошибка миграции»
Change postgres-storage, задача 9.2
Дата 2026-10-01 13:43 UTC
Commit 125145d
Стенд compose проекта (postgres, migrate, api), volume postgres_data с данными
Хост Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались

Как сломана миграция

Override-файл compose вне репозитория меняет у migrate только имя базы. docker-compose.yml и .env не правились:

# broken-migrate.yml
services:
  migrate:
    environment:
      DATABASE__NAME: no_such_db

Запуск

$ make down                                                   # exit 0, volume остаётся
$ docker compose -f docker-compose.yml -f broken-migrate.yml up -d    # exit 1
Container mtusi-lab2-postgres-1 Started
Container mtusi-lab2-postgres-1 Healthy
Container mtusi-lab2-migrate-1 Started
Container mtusi-lab2-migrate-1 Error service "migrate" didn't complete successfully: exit 1
service "migrate" didn't complete successfully: exit 1

$ docker compose ps -a
mtusi-lab2-api-1  Created
mtusi-lab2-migrate-1  Exited (1) Less than a second ago
mtusi-lab2-postgres-1  Up 2 seconds (healthy)
Проверка Результат
DATABASE__NAME в окружении migrate no_such_db
docker inspect контейнера api status=created, StartedAt 0001-01-01T00:00:00Z: не запускался
GET /health/live на 127.0.0.1:8080 соединение не установлено
пароль Postgres в выводе up и журнале migrate нет

Журнал migrate

docker compose logs --no-log-prefix migrate: строка JSON о старте, затем traceback Python (178 строк). Последние строки:

{"event": "Running alembic", "level": "info", ...}
…
  File "/app/.venv/lib/python3.12/site-packages/sqlalchemy/dialects/postgresql/asyncpg.py", line 840, in _handle_exception_no_connection
    raise translated_error from error
sqlalchemy.exc.DBAPIError: (sqlalchemy.dialects.postgresql.asyncpg.Error) database "no_such_db" does not exist
(Background on this error at: https://sqlalche.me/e/21/dbapi)

Возврат

make run_docker без override-файла пересоздал migrate с именем базы из POSTGRES_DB:

mtusi-lab2-api-1  Up 2 seconds (healthy)
mtusi-lab2-migrate-1  Exited (0) 2 seconds ago
mtusi-lab2-postgres-1  Up 15 seconds (healthy)
GET /health/ready -> 200

Вывод

Если migrate завершился ошибкой, depends_on: service_completed_successfully не даёт запустить API. Контейнер создан, но не стартовал, а up возвращает ненулевой код. Причина видна в журнале migrate. Ошибку alembic CLI печатает обычным traceback, а не JSON-строкой.