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

Классическая сцена. Твоё приложение спрашивает у модели что-то большое. Ответ обрывается ровно на тридцатой секунде.
Ты гуглишь, находишь совет «подними лимит функции», поднимаешь его до пяти минут — и всё равно обрыв на тридцатой. Магия? Нет. Просто ты поднял не тот таймаут.
Таймаут — это обещание, а не ошибка
Таймаут — заранее объявленный предел ожидания: «жду ответа столько-то секунд, потом бросаю трубку».
Звучит как вредность, но без него всё встаёт. Соединение, которое ждёт вечно, занимает память и слот, и через пару сотен таких зависших запросов сервер ложится целиком. Таймаут — это защита от тихого залипания: лучше честная ошибка через минуту, чем вкладка, крутящаяся до конца времён.
Ключевое, что стоит понять сразу: таймаут не про скорость, а про терпение. Медленный ответ — это задержка. Оборванный — это чьё-то кончившееся терпение.
Их несколько, и побеждает самый короткий
Вот что мало кто держит в голове: запрос проходит через цепочку, и у каждого звена свой таймаут.
Типичная цепочка запроса к ИИ:
- Браузер / твой
fetch— сколько ждёт фронтенд. - CDN или прокси перед сайтом — Cloudflare, nginx.
- Сервер или serverless-функция — тот лимит, который ты и полез крутить.
- SDK модели — у клиентских библиотек свой лимит по умолчанию.
- База данных — свой лимит на запрос.
Рвёт всегда самое нетерпеливое звено. Поднял лимит на четвёртом — а обрывает второе, и ничего не изменилось.
Показательная история — «лимит 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 коротких урока на телефоне.





