- 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>
71 lines
4.7 KiB
Markdown
71 lines
4.7 KiB
Markdown
# `statement_timeout`: 503, а в журнале нет параметров SQL
|
||
|
||
| | |
|
||
|---|---|
|
||
| Спеки | `data-storage` «Ограниченный пул соединений и таймауты» (истёкший таймаут — 503); `service-logging` «Без содержимого сообщений и личных данных» |
|
||
| Change | `postgres-storage`, задача 9.1 (дефект нашёл `/opsx:verify`) |
|
||
| Дата | 2026-10-01 13:39 UTC (до), 13:42 UTC (после) |
|
||
| Commit | до — образ из `2d0a7c8` (в `/app/src/infra/db/engine.py` нет `hide_parameters`); после — `125145d` |
|
||
| Стенд | `make run_docker` (compose: postgres, migrate, api), API на `127.0.0.1:8080` |
|
||
| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались |
|
||
| Таймауты | по умолчанию: `statement_timeout_ms=5000`, `request_timeout_seconds=6` |
|
||
| Клиент | разовый stdlib-скрипт. Текст T — синтетическая строка `SYNTHETIC-<uuid>`, проверяется только её наличие в журнале. Id сокращены |
|
||
|
||
## Как воспроизведено
|
||
|
||
Таблица `messages` на 8 с захвачена в отдельной сессии `psql`:
|
||
|
||
```sql
|
||
BEGIN; LOCK TABLE messages IN ACCESS EXCLUSIVE MODE; SELECT pg_sleep(8); COMMIT;
|
||
```
|
||
|
||
Через 1 с после захвата alice отправляет сообщение с текстом T.
|
||
`INSERT` ждёт блокировку, через 5 с Postgres отменяет его по
|
||
`statement_timeout` (SQLSTATE `57014`), и `get_db_session` переводит
|
||
`DBAPIError` в 503 с записью `warning`.
|
||
|
||
## До: образ из `2d0a7c8`, без `hide_parameters`
|
||
|
||
| Запрос | Статус | Результат | Время |
|
||
|---|---|---|---|
|
||
| `POST …/messages` (alice, текст T) | 503 | `unavailable` | 5,05 с |
|
||
| `POST …/messages` (после снятия блокировки) | 201 | id `29e7c6c2…` | 0,02 с |
|
||
|
||
```json
|
||
{"timestamp": "2026-10-01T13:40:01.548127Z", "event": "Database is unavailable", "error_type": "DBAPIError", "error": "(sqlalchemy.dialects.postgresql.asyncpg.Error) canceling statement due to statement timeout\n[SQL: INSERT INTO messages (id, chat_id, sender_id, text, created_at) VALUES ($1::UUID, $2::UUID, $3::UUID, $4::VARCHAR, $5::TIMESTAMP WITH TIME ZONE)]\n[parameters: (UUID('a4817181-248e-47d5-a834-057f322f9e70'), UUID('77751dff-1589-42ba-9c75-9eb5f0fc0fe1'), UUID('b3733c1a-bb29-4977-b3d8-b6c4c655dd99'), 'SYNTHETIC-a9a422599076455184c9abca6227c3c2', datetime.datetime(2026, 10, 1, 13, 39, 56, 526563, tzinfo=datetime.timezone.utc))]\n(Background on this error at: https://sqlalche.me/e/21/dbapi)", "level": "warning"}
|
||
```
|
||
|
||
| Проверка журнала за время сценария | Результат |
|
||
|---|---|
|
||
| текст T встречается | **да** |
|
||
| `[parameters: ...]` встречается | **да** |
|
||
|
||
## После: `125145d`, `hide_parameters=True`
|
||
|
||
| Запрос | Статус | Результат | Время |
|
||
|---|---|---|---|
|
||
| `POST …/messages` (alice, текст T) | 503 | `unavailable` | 5,04 с |
|
||
| `POST …/messages` (после снятия блокировки) | 201 | id `0e93be85…` | 0,04 с |
|
||
|
||
Текст ошибки в ответе: `Service is temporarily unavailable`.
|
||
|
||
```json
|
||
{"timestamp": "2026-10-01T13:42:17.053907Z", "event": "Database is unavailable", "error_type": "DBAPIError", "error": "(sqlalchemy.dialects.postgresql.asyncpg.Error) canceling statement due to statement timeout\n[SQL: INSERT INTO messages (id, chat_id, sender_id, text, created_at) VALUES ($1::UUID, $2::UUID, $3::UUID, $4::VARCHAR, $5::TIMESTAMP WITH TIME ZONE)]\n[SQL parameters hidden due to hide_parameters=True]\n(Background on this error at: https://sqlalche.me/e/21/dbapi)", "level": "warning"}
|
||
```
|
||
|
||
| Проверка журнала за время сценария | Результат |
|
||
|---|---|
|
||
| текст T встречается | нет |
|
||
| `[parameters: ...]` встречается | нет |
|
||
| `SQL parameters hidden due to hide_parameters=True` | да |
|
||
|
||
## Вывод
|
||
|
||
- `statement_timeout` даёт 503 `unavailable` через 5 с, раньше срока
|
||
запроса 6 с. После снятия блокировки сервис отвечает 201 без
|
||
рестарта.
|
||
- До исправления строка ошибки драйвера несла все параметры `INSERT`,
|
||
включая текст сообщения. С `hide_parameters=True` в журнале остаются
|
||
SQL и причина, а параметров нет. Тот же флаг скрывает их и в
|
||
traceback ошибки 500.
|