Что такое…

Что такое таймаут — и почему запрос рвётся не там, где ты думаешь

Иллюстрация: письмо едет по цепочке из четырёх песочных часов, самые маленькие обрываются первыми

Классическая сцена. Твоё приложение спрашивает у модели что-то большое. Ответ обрывается ровно на тридцатой секунде.

Ты гуглишь, находишь совет «подними лимит функции», поднимаешь его до пяти минут — и всё равно обрыв на тридцатой. Магия? Нет. Просто ты поднял не тот таймаут.

Таймаут — это обещание, а не ошибка

Таймаут — заранее объявленный предел ожидания: «жду ответа столько-то секунд, потом бросаю трубку».

Звучит как вредность, но без него всё встаёт. Соединение, которое ждёт вечно, занимает память и слот, и через пару сотен таких зависших запросов сервер ложится целиком. Таймаут — это защита от тихого залипания: лучше честная ошибка через минуту, чем вкладка, крутящаяся до конца времён.

Ключевое, что стоит понять сразу: таймаут не про скорость, а про терпение. Медленный ответ — это задержка. Оборванный — это чьё-то кончившееся терпение.

Их несколько, и побеждает самый короткий

Вот что мало кто держит в голове: запрос проходит через цепочку, и у каждого звена свой таймаут.

Типичная цепочка запроса к ИИ:

  1. Браузер / твой fetch — сколько ждёт фронтенд.
  2. CDN или прокси перед сайтом — Cloudflare, nginx.
  3. Сервер или serverless-функция — тот лимит, который ты и полез крутить.
  4. SDK модели — у клиентских библиотек свой лимит по умолчанию.
  5. База данных — свой лимит на запрос.

Рвёт всегда самое нетерпеливое звено. Поднял лимит на четвёртом — а обрывает второе, и ничего не изменилось.

Показательная история — «лимит 10 секунд на бесплатном хостинге». Совет кочует по форумам с 2023 года и давно протух: у Vercel сегодня по умолчанию 300 секунд даже на Hobby, а на платных тарифах максимум доходит до 800 секунд и до 30 минут в бете. Так что если тебя рвёт на тридцатой — это точно не хостинг.

Как вычислить виновника за две минуты

Хорошая новость: обрыв почти всегда подписан. Смотри на две вещи.

Секунда обрыва. Она стабильная и круглая — это подпись слоя. Всегда ровно 30, 60 или 100? Значит, лимит выставлен, и надо просто вспомнить, кем.

  • ~100 секунд и страница с ошибкой 524 — это Cloudflare: он ждал ответа от твоего сервера и не дождался.
  • Ровно 60 секунд на своём сервере — почти наверняка nginx с настройкой по умолчанию.
  • Плавающее время без круглого числа — это не таймаут, а падение или обрыв сети.

Кто прислал ошибку. Красивая страница ошибки от Cloudflare — рвал Cloudflare. Текст ETIMEDOUT или AbortError в консоли браузера — рвал клиент. Запись в логах функции «task timed out» — рвал хостинг. Каждый слой жалуется своим голосом.

Дальше — правило, экономящее часы: чини самое короткое звено, а не самое заметное. Обычно достаточно поднять лимит там и оставить остальные в покое.

Когда задача честно долгая

Бывает, что дело не в настройках: работа реально идёт три минуты. Задирать таймауты по всей цепочке — плохой путь: пользователь всё это время смотрит на спиннер, а один разрыв сети обнуляет результат.

Два нормальных решения.

Стриминг. Ответ идёт по кусочкам, соединение живёт постоянным потоком, а первый текст появляется через секунду. Заодно снимает половину вопросов к скорости — как это сделать, у нас разобрано отдельно.

Очередь. Приложение сразу отвечает «задачу принял, вот её номер», работа уходит в фон, а результат клиент забирает опросом или получает вебхуком. Так делают все, кто генерирует видео и большие отчёты: там минуты ожидания — норма, и держать HTTP-соединение открытым бессмысленно. Особенно это важно на serverless, где долгая функция ещё и тарифицируется по времени.

Что унести с собой: таймаут — не поломка, а чьё-то терпение, которое кончилось первым. Найди самое нетерпеливое звено по круглой секунде и по голосу ошибки — и почини именно его.

Какой таймаут ставить по умолчанию?

Для обычного API-запроса хватает 10–30 секунд. Для запросов к ИИ — 60–120, а если ответ длинный, лучше вообще перейти на стриминг. Главное правило: у внешнего звена (браузера) таймаут должен быть больше, чем у внутреннего, иначе клиент бросит трубку раньше, чем сервер успеет ответить.

Чем таймаут отличается от ошибки 504?

504 Gateway Timeout — это конкретный случай таймаута: прокси или шлюз не дождался ответа от сервера позади себя. У Cloudflare тот же смысл имеет своя ошибка 524. Таймаут как явление шире: он бывает и на клиенте, и в базе, и вообще без HTTP.

Повторять ли запрос после таймаута?

Осторожно. Если запрос только читает данные — повторяй смело. Если он что-то создаёт (платёж, письмо, заказ), помни: сервер мог успеть выполнить работу и просто не успел ответить. Повтор без защиты от дублей приведёт ко второму списанию.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →