Код 504 на экране не означает, что приложение остановило работу. Reverse proxy мог закрыть ожидание, а upstream позже завершил импорт или списание. Поэтому не повторяйте запрос сразу: найдите его request ID и проверьте side effect, иначе получите дубли.

Сравните четыре ограничения — клиента, load balancer, NGINX и приложения. Исправлять нужно самый ранний обрыв и модель операции. Глобальный timeout на десять минут удержит connections и workers, но не даст пользователю надёжного способа узнать итог после потери сети.

Временная шкала показывает владельца разрыва

МоментСигналВывод
30 sКлиент отменил fetchBrowser/client timeout раньше proxy
60 sNGINX пишет upstream timed outМежду чтениями upstream прошло больше proxy_read_timeout
65 sПриложение пишет successРабота продолжилась после ответа 504
120 sDB statement timeoutОперацию остановила база, а не proxy
Нет completionWorker завис или был отменёнНужны 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.

Проверка включает неизвестный результат

  1. Запустить тестовую задачу и получить 202 со status URL.
  2. Разорвать клиентское соединение после принятия.
  3. Убедиться, что job завершился ровно один раз.
  4. Повторить create с тем же idempotency key.
  5. Получить существующий job и один result.
  6. Смоделировать failure worker и увидеть terminal failed без вечного running.

Данные для разбора 504

Подготовьте конфигурацию конкретного location, таймауты внешнего load balancer и клиента, access/error log с request ID, trace upstream и сведения о side effects. Тела пользовательских запросов и access tokens для сравнения временной шкалы не нужны.

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