- 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>
3.2 KiB
3.2 KiB
Ошибка миграции: 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-строкой.