599 Network Connect Timeout Error ("ошибка тайм-аута сетевого подключения")

https://httpcat.ru/599

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 599 Network Connect Timeout Error — неофициальный HTTP-статус, используемый HTTP-клиентами (например, curl, Python Requests, Elasticsearch, Tornado), когда происходит таймаут на уровне сетевого соединения, а от сервера не поступает даже HTTP-заголовка.

Основные характеристики:

Код 599 **не определён в спецификациях HTTP**, но используется в клиентских библиотеках для отражения сетевых проблем
Чаще всего означает, что:
- сервер не ответил в течение заданного времени,
- TCP-соединение не было установлено,
- или было прервано до возврата ответа.
Не путать с 504 Gateway Timeout — там ошибка у прокси, а 599 чаще всего исходит от клиента

Типичное использование:

GET /data HTTP/1.1
Host: api.example.com

# Клиентский таймаут

HTTP/1.1 599 Network Connect Timeout Error
Content-Type: application/json

{
    "error": "Network timeout",
    "message": "The server did not respond in time"
}

Когда возникает:

Если клиент (например, Requests, Tornado, curl) не получил от сервера **никакого ответа** в отведённое время
Если TCP-соединение было закрыто до получения заголовков
Если сервер «молчит» или уходит в глубокую нагрузку

Особенности заголовков:

Content-Type — зависит от реализации, иногда отсутствует вовсе
Часто возвращается **не сервером**, а библиотекой клиента

Дополнительно:

599 используется в Tornado, Requests, Elasticsearch, curl, Scrapy и других HTTP-клиентах
Не следует использовать его в серверных API-ответах — он предназначен для внутренней диагностики
В логах может означать: "сервер завис", "неверный DNS", "фаервол прервал соединение", "таймаут клиента"

Документация: https://http.dev/599