Коды ответов и ошибок сервера

Когда мы погружаемся в мир интернета, кажется, что за каждым кликом стоит простой и мгновенный переход с одной страницы на другую. Однако на самом деле за этим скрывается сложный и тщательно организованный процесс обмена данными между нашим устройством и удалёнными серверами. Каждый запрос, который мы отправляем, например, вводя URL в адресной строке или кликая на ссылку, запускает цепочку взаимодействий, где браузер связывается с хостом, а сервер обрабатывает запрос и отправляет ответ.

В этом процессе ключевую роль играют коды состояния HTTP (Hypertext Transfer Protocol), которые выполняют функцию "языка общения" между клиентом и сервером. Эти коды не видны глазу пользователя, но каждый из них несет важную информацию о том, как был обработан запрос: успешно ли доставлен контент, требуется ли перенаправление или произошла ошибка. HTTP-коды помогают нам понять, что значит сбой или предупреждение, возникающие на веб-страницах, и дают разработчикам важные сигналы для диагностики и исправления проблем.

В этой статье мы подробно рассмотрим, что представляют собой коды HTTP, разберем их значения и объясним, какие действия можно предпринять, чтобы исправить ошибки, возникающие на сервере или со стороны клиента. Понимание этих кодов — ключ к эффективному функционированию веб-сайтов и приложений, обеспечивая их бесперебойную работу и доступность для пользователей.

Как пользователи сталкиваются с HTTP-ошибками

Когда пользователь взаимодействует с интернетом, он может сталкиваться с кодами ошибок HTTP, когда что-то идет не так в процессе загрузки страницы. Эти ошибки обычно появляются в браузере в виде сообщений, которые объясняют, почему запрос не может быть выполнен. Несмотря на то, что пользователи не всегда видят технические коды, они могут заметить, что страница не открывается, и появляется предупреждение, например, что страница не найдена или доступ к ней запрещён.

Одна из самых распространённых ситуаций — это когда пользователь вводит неверный адрес или пытается попасть на удалённую или перемещённую страницу. В таком случае браузер покажет сообщение, что страница не найдена, и предложит проверить правильность ввода. Другой частый сценарий — это ограничение доступа. Если на сайте требуются логин и пароль, но пользователь не авторизован, система может запретить ему доступ к содержимому и сообщить об этом. Иногда ошибки связаны с проблемами на самом сервере: например, когда сервер перегружен или проводятся технические работы. В таких случаях сайт может быть временно недоступен, и браузер уведомит пользователя, предложив зайти позже.

Кроме того, иногда могут происходить перенаправления, когда пользователь пытается открыть одну страницу, но его автоматически отправляют на другую. Это может происходить настолько быстро, что остаётся практически незамеченным, хотя иногда такие перенаправления могут замедлить загрузку страницы.

Таким образом, даже если коды ошибок остаются «за кулисами», пользователи постоянно сталкиваются с их проявлениями — от уведомлений о временных неполадках сайта до сообщений о неправильных действиях, таких как неверный URL или отсутствующий доступ. Эти сигналы помогают пользователю понять, что происходит, и либо принять меры, либо просто подождать.

Коды статусов HTTP

Когда пользователь нажимает на ссылку или вручную вводит URL в адресной строке браузера, начинается процесс отправки запроса на сервер. Этот запрос передает данные о том, какой ресурс нужен, и в каком формате. В ответ на него сервер возвращает уникальный трёхзначный код, который информирует о статусе выполнения запроса. Эти коды варьируются от 100 до 599 и выполняют важную роль в обмене данными, сообщая о текущем состоянии сервера или проблемах, возникших при обработке запроса.

Коды статусов HTTP делятся на пять основных категорий:

1xx: информационные сообщения

Эти коды означают, что запрос принят и находится в процессе обработки. Обычно эти сообщения используются для специфических случаев и нечасто встречаются в стандартных веб-запросах.

• 100 Continue — сервер получил начальную часть запроса и клиент может продолжать отправку.
• 101 Switching Protocols — сервер принял запрос клиента на смену протоколов.
• 102 Processing — сервер сигнализирует, что принял запрос, но на обработку требуется больше времени. Клиенту не нужно разрывать соединение, он должен сбросить таймер и дождаться следующей команды.
• 103 Early hints — сервер вернет несколько заголовков ответа перед финальным HTTP-сообщением.

2xx: успешные запросы

Эта группа указывает на то, что запрос был успешно получен, понят и обработан.

• 200 OK — стандартный ответ, указывающий на успешное выполнение запроса.
• 201 Created — запрос привел к созданию нового ресурса (например, запись в базе данных).
• 202 Accepted — сервер принял запрос, но не завершил его обработку. Запрос можно отклонить, поскольку на его выполнение может потребоваться слишком много времени.
• 203 Non-Authoritative Information — означает, что операция прошла успешно, но от кода 200 он отличается указанием источника информации. Данные получены не из первоисточника, а с другого сервера или резервной копии. Возможно, информация устарела, о чем и предупреждает код ответа.
• 204 No Content — запрос выполнен, но ответа от сервера (например, данных) не требуется.
• 205 Reset Content — сервер сигнализирует, что запрос успешно обработан и клиенту нужно сбросить введенные данные. Обновление документа не требуется, сервер не передает тело сообщения.
• 206 Partial Reset — сервер в ответе возвращает только часть контента страницы, которую и запрашивает пользователь.
• 207 Multi-Status — сервер обработал несколько операций не зависящих друг от друга. Результаты отображаются в теле сообщения как XML-документ с объектом multistatus.
• 226 IM Used — сервер успешно завершил операцию: принял заголовок A-IM и вернул содержимое с учетом указанных параметров.

3xx: перенаправления

Коды перенаправления означают, что клиенту нужно предпринять дополнительные действия для завершения запроса. Часто такие коды связаны с перенаправлением на другой URL.

• 300 Multiple Choices — робот не может проиндексировать страницу, поскольку не может сопоставить ресурс и URL. Частая причина — ресурс перемещен на другой адрес. Сервер предлагает клиенту выбор альтернатив для перехода. Для успешной индексации нужно либо правильно указать ресурс, либо поправить заголовки.
• 301 Moved Permanently — запрашиваемый ресурс был перемещен на постоянный новый URL.
• 302 Found — временное перенаправление, ресурс доступен по другому адресу, но это может измениться.
• 303 See Other — сервер сигнализирует, что ресурс, который указан в запросе, расположен на другом адресе. Обычно он используется для перенаправления пользователя к выбранному ресурсу выводом данных POST-активированного скрипта. В ответе сервера будет указан адрес, по которому нужно искать результат, удовлетворяющий запрос.
• 304 Not Modified — клиент может использовать кэшированную версию ресурса, так как он не изменялся.
• 305 Use Proxy — связан с безопасностью данных. Сервер выдает код 305, если доступ к ресурсу, который запрашивает клиент, возможен только с прокси. Прокси указан там же в ответе сервера.
• 307 Temporary Redirect — код 307 похож на 302, но дает более конкретный ответ. Код означает, что ресурс, который требует клиент, на время переведен на другой адрес, а новый URL нужно прописать в Location.
• 308 Permanent Redirect — код является преемником кода 301.

4xx: ошибки клиента

Эти коды сигнализируют о том, что проблема возникла на стороне клиента — некорректный запрос, отсутствие необходимых прав или ресурса.

• 400 Bad Request — сервер не смог понять запрос из-за неверного синтаксиса.
• 401 Unauthorized — для доступа к ресурсу требуется аутентификация.
• 403 Forbidden — сервер понял запрос, но отказывается его выполнить.
• 404 Not Found — ресурс, на который направлен запрос, не найден.
• 405 Method Not Allowed — метод HTTP, используемый в запросе, не поддерживается данным ресурсом (например, попытка отправить GET-запрос на URL, который требует POST).
• 405 Method Not Allowed — недоступен метод, которым совершается запрос. Сервер выдает этот код для конкретных отдельных объектов на странице. Например, строка запроса, запускающая скрипт, отличается от запроса, который совершает пользователь.
• 406 Not Acceptable — означает, что запрашиваемый файл существует, запрос сформулирован верно, но кодировка документа недоступна для расшифровки роботом.
• 407 Proxy Authentication Required — код похож на 401, этот код используется, если вопрос корректен, но клиент может получить доступ к документу только с помощью авторизации через прокси. Клиент авторизуется, если прокси вернет поле с заголовком proxy-authenticate.
• 408 Request Timeout — сервер возвращает этот код ответа, если в установленное время ожидания клиент не сделал ни один запрос. Код 408 не возвращается, если пользователь сам отменил запрос, или соединение оборвалось, а отправить ответ нет возможности.
• 409 Conflict — код означает, что в системе конфликт. Например, пользователь загружает файл на сервер, где уже есть такой файл в новой версии.
• 410 Gone — код ответа похож на 404 код, он означает, что документ, к которому направлен запрос, больше недоступен. Если сервер возвращает код 404, то робот еще вернется на страницу, чтобы проверить ее состояние, а в случае ответа 410 робот поймет, что страница удалена навсегда.
• 411 Length Required — сервер не может принять и обработать запрос, если в заголовке content-length не указана длина контента.
• 413 Request Entity Too Large — если в теле запроса слишком большой объем информации и сервер не может обработать такой большой запрос, то он возвращает код ошибки 413. Если это временная проблема, в поле Retry-After сервер укажет время, которое нужно подождать.
• 414 Request-URL Too Long — код ответа похож на 413 код, за исключением того, что 414 код отображается, если в запросе указан слишком длинный URL.
• 422 Unprocessable Entity — сервер возвращает этот код, если он принял и распознал запрос, но в теле запроса допущена логическая ошибка, которая мешает его выполнить.
• 424 Failed Dependency — если выполнение этой операции зависит от исхода других связанных с ней операций, сервер вернет этот запрос.
• 429 Too Many Requests — код 429 означает, что пользователь посылает слишком много запросов за короткий временной промежуток, и сервер не может обработать такое количество.
• 431 Request Header Fields Too Large — если в запросе указаны слишком большие поля заголовков, сервер не сможет справиться с таким запросом и вернет код ошибки 431.
• 451 Unavailable For Legal Reasons — код отображает то же, что и 403, но с уточнениями. Он используется, если доступ к серверу заблокирован по решению суда, обычно из-за нарушения авторских прав, а также если доступ закрыт на государственном уровне.
• 418 I'm a teapot — забавный код, возвращающий ошибку "Я чайник", связан с гипертекстовым протоколом управления кофеваркой — Hyper Text Coffee Pot Control Protocol. Ошибка означает, что запрос некорректен, с помощью чайника нельзя приготовить кофе. Протокол и код этой ошибки были созданы в шутку в 1998 году к 1 апреля.

• 422 Unprocessable Entity — клиентский запрос содержит семантические ошибки, и сервер не может его обработать.
• 425 Too Early — ошибка появляется когда сервер не желает обрабатывать запрос, поскольку он может быть воспроизведен повторно.
• 426 Upgrade required — из-за содержимого поля заголовка обновления запросов клиенту необходимо переключиться на другой протокол.
• 428 Precondition Required — перед обработкой запроса сервер требует указания условий.
• 429 Too many requests — код генерируется сервером, когда пользователь отправил слишком много запросов за определенный промежуток времени. Также известен как ограничение скорости.
• 431 Request Header Fields Too Large — сервер не может обработать запрос, потому что поля заголовка слишком велики. Это может указывать на проблему с одним или всеми полями заголовка.
• 451 Unavailable For Legal Reasons — оператору сервера поступило требование запретить доступ к запрашиваемым клиентом ресурсам.
• 499 Client closed request — код возвращается NGINX, когда клиент закрывает запрос, пока Nginx все еще обрабатывает его.

5xx: ошибки сервера

Эти коды указывают на сбой на стороне сервера, когда запрос клиента был корректным, но сервер не смог его обработать.

• 500 Internal Server Error — общая ошибка сервера, произошедшая из-за проблем с серверной стороной.
• 501 Not Implemented — сервер возвращает этот код, когда не может обработать запрос: он не поддерживает возможности для обработки или не может распознать метод. Например, эта ошибка появится, если распространенные протоколы HEAD, POST, GET и другие по какой-то причине не поддерживаются сервером.
• 502 Bad Gateway — сервер, действующий как шлюз или прокси, получил некорректный ответ от вышестоящего сервера.
• 503 Service Unavailable — сервер временно недоступен, обычно из-за перегрузки или технического обслуживания.
• 504 Gateway Timeout — сервер-прокси не получил вовремя ответ от вышестоящего сервера.
• 505 HTTP Version not supported — сервер не поддерживает версию HTTP, которую клиент использовал для выполнения запроса.
• 506 Variant Also Negotiates — сервер настроен некорректно: ошибка в конфигурации зацикливает обращение сервера, и он указывает сам на себя.
• 507 Insufficient Storage — если сервер загружен настолько, что для выполнения запроса не хватает памяти, он вернет ошибку 507. Это бывает, если на сервере нет места для данных в принимаемом запросе.
• 510 Not Extended — код 510 возвращается в случае, если сервер не поддерживает расширение, которое указано в запросе. В этом же ответе сервер может указать, какие расширения доступны.
• 511 Network Authentication Required — ошибка возвращается клиенту, если пользователь не авторизовался в сети. Например, если он не согласился на условия использования интернета, когда подключался к wi-fi, или не ввел пароль.

Проверить номера ошибок протокола HTTP и их значения можно с помощью нескольких методов:

Инструменты для разработчиков в браузерах

Встроенные инструменты разработчика в браузерах, таких как Google Chrome, Mozilla Firefox и Microsoft Edge, позволяют отслеживать запросы и коды HTTP в реальном времени. Для этого:

• Откройте инструменты разработчика (обычно по клавише F12).
• Перейдите на вкладку "Network" (Сеть).
• Обновите страницу — все запросы будут отображены вместе с кодами статусов.

Команды в консоли

Используйте утилиту curl или wget в командной строке для отправки запросов и получения ответов с кодами.

Онлайн-сервисы

HTTPStatus.io — онлайн-инструмент для проверки кодов HTTP и анализа состояния сервера. Он позволяет ввести URL сайта и получить информацию о коде статуса, который возвращает сервер.

Логи сервера

Логи веб-серверов, таких как Apache или Nginx, содержат коды ошибок HTTP для всех запросов. Это наиболее надежный источник для детального анализа проблем, происходящих на сервере.

Использование этих методов поможет быстро найти информацию о кодах HTTP и выяснить причины ошибок или состояний.

Как и когда можно исправить ошибки

4xx: ошибки клиента

400 Bad Request

• Проверьте правильность URL.
• Проверьте корректность передаваемых данных (например, JSON, формы).
• Убедитесь, что запрос отправляется через правильный метод (GET, POST и т.д.).

401 Unauthorized

• Проверьте наличие правильных учетных данных (логин, пароль, токен).
• Обновите токены или убедитесь, что пользователь авторизован.

403 Forbidden

• Проверьте права доступа к ресурсу (правильные учетные данные).
• Обновите права доступа на сервере, если необходимо.

404 Not Found

• Проверьте URL на наличие ошибок.
• Убедитесь, что ресурс существует на сервере.
• Настройте корректные перенаправления для устаревших URL.

405 Method Not Allowed

• Проверьте, какой HTTP-метод поддерживается ресурсом.
• Измените метод запроса в соответствии с тем, что поддерживается.

5xx: ошибки сервера

500 Internal Server Error

• Проверьте логи сервера для диагностики проблемы.
• Исправьте ошибки в коде серверного приложения.

502 Bad Gateway

• Проверьте, доступен ли вышестоящий сервер.
• Убедитесь, что все промежуточные серверы корректно передают запросы.

503 Service Unavailable

• Проверьте, не перегружен ли сервер.
• Убедитесь, что сервер работает корректно и не находится на обслуживании.

504 Gateway Timeout

• Увеличьте тайм-аут соединения на сервере.
• Убедитесь, что вышестоящий сервер отвечает вовремя.

Документация и справочники

• MDN Web Docs (Mozilla Developer Network) — один из самых популярных и доступных справочников по кодам статусов HTTP. Здесь вы найдете полные описания каждого кода с примерами и рекомендациями по устранению ошибок.
• Официальная документация IETF (Internet Engineering Task Force) — все протоколы и стандарты интернета, включая HTTP, описаны в RFC-документах. Например, HTTP/1.1 описан в RFC 7231.

Резюме

Понимание кодов ошибок HTTP помогает оперативно находить и устранять проблемы в работе сайтов и веб-приложений. Своевременная диагностика и коррекция таких ошибок улучшает пользовательский опыт и помогает поддерживать бесперебойную работу серверов.