Код 504 на экране не означает, что приложение остановило работу. Reverse proxy мог закрыть ожидание, а upstream позже завершил импорт или списание. Поэтому не повторяйте запрос сразу: найдите его request ID и проверьте side effect, иначе получите дубли.
Сравните четыре ограничения — клиента, load balancer, NGINX и приложения. Исправлять нужно самый ранний обрыв и модель операции. Глобальный timeout на десять минут удержит connections и workers, но не даст пользователю надёжного способа узнать итог после потери сети.
Временная шкала показывает владельца разрыва
| Момент | Сигнал | Вывод |
|---|---|---|
| 30 s | Клиент отменил fetch | Browser/client timeout раньше proxy |
| 60 s | NGINX пишет upstream timed out | Между чтениями upstream прошло больше proxy_read_timeout |
| 65 s | Приложение пишет success | Работа продолжилась после ответа 504 |
| 120 s | DB statement timeout | Операцию остановила база, а не proxy |
| Нет completion | Worker завис или был отменён | Нужны trace и состояние job |
NGINX определяет proxy_read_timeout как интервал между двумя последовательными чтениями ответа, а не как максимальную длительность всего response. Поток, который периодически отправляет данные, может жить дольше значения; молчащий upstream будет закрыт.
Локальный timeout подходит только ограниченному endpoint
location /api/reports/preview {
proxy_pass http://app_backend;
proxy_connect_timeout 5s;
proxy_send_timeout 30s;
proxy_read_timeout 120s;
}
# Значения условные: согласуйте их с лимитом приложения
# и не переносите 120s на все маршруты.Увеличение оправдано, если операция имеет доказанный верхний предел, не занимает дефицитный worker и не создаёт повтор при disconnect. После изменения проверяют нагрузку на connections, upstream concurrency и поведение клиента чуть до и чуть после новой границы.
Долгая работа становится отдельным ресурсом
Для импорта, генерации архива или массового пересчёта API создаёт job, сохраняет idempotency key и быстро отвечает 202 Accepted. RFC 9110 описывает 202 как принятую, но ещё не завершённую обработку; ответ должен указывать текущее состояние и status monitor.
HTTP/1.1 202 Accepted
Location: /api/jobs/job_7f3
Retry-After: 5
Content-Type: application/json
{"id":"job_7f3","status":"queued",
"status_url":"/api/jobs/job_7f3"}Идентификатор в примере условный. Status endpoint возвращает queued, running, succeeded, failed или cancelled и ссылку на result только после готовности. Повтор создания с тем же ключом возвращает тот же job, а не запускает второй экспорт.
Отмена соединения и отмена задачи — разные события
Некоторые frameworks передают cancellation upstream, другие продолжают handler. Проверьте именно свой стек. Бизнес-операцию с внешним side effect нельзя прерывать в случайной точке только потому, что browser закрыл вкладку; ей нужны транзакция, checkpoint или компенсирующее действие.
- Хранить request ID и job ID в одном trace.
- Ограничить число параллельных тяжёлых jobs на пользователя.
- Ставить deadline внешним вызовам внутри worker.
- Публиковать прогресс только по подтверждённым checkpoint.
- Очищать результаты и jobs по объявленному retention.
Проверка включает неизвестный результат
- Запустить тестовую задачу и получить 202 со status URL.
- Разорвать клиентское соединение после принятия.
- Убедиться, что job завершился ровно один раз.
- Повторить create с тем же idempotency key.
- Получить существующий job и один result.
- Смоделировать failure worker и увидеть terminal failed без вечного running.
Данные для разбора 504
Подготовьте конфигурацию конкретного location, таймауты внешнего load balancer и клиента, access/error log с request ID, trace upstream и сведения о side effects. Тела пользовательских запросов и access tokens для сравнения временной шкалы не нужны.