Подробное руководство по 5xx ошибкам сервера: классификация HTTP статусов 500, 502, 503, 504, причины появления, методы диагностики и пошаговые инструкции по исправлению. С примерами кода и чек-листом.
5xx ошибка сервера - это группа HTTP статус-кодов, которые указывают на сбой на стороне сервера. Когда браузер пользователя отправляет запрос, сервер обрабатывает его и возвращает ответ. Если на каком-то этапе происходит сбой - превышено время ожидания, упал процесс, переполнена память - сервер возвращает код 5xx. В этой статье разберём все основные ошибки группы 500, их причины, методы диагностики и пошаговые инструкции по исправлению.
HTTP статус-коды делятся на пять групп. Первая цифра указывает на тип ответа:
Когда пользователь видит сообщение вроде «500 Internal Server Error» или «502 Bad Gateway», это означает, что сервер не смог корректно обработать запрос. Проблема не в браузере пользователя и не в его интернет-соединении - сбой произошёл на стороне веб-сервера, приложения или базы данных.
Ниже приведены все основные коды группы 5xx с описанием и типичными причинами.
| Код | Название | Описание | Типичная причина |
|---|---|---|---|
| 500 | Internal Server Error | Внутренняя ошибка сервера | Ошибка в .htaccess, превышен лимит памяти, сбой скрипта |
| 501 | Not Implemented | Метод не поддерживается | Сервер не поддерживает HTTP-метод запроса |
| 502 | Bad Gateway | Некорректный ответ от вышестоящего сервера | Перезагрузка PHP-процесса, сбой прокси-сервера |
| 503 | Service Unavailable | Сервер недоступен | Перегрузка, техническое обслуживание, нехватка ресурсов |
| 504 | Gateway Timeout | Превышено время ожидания | Медленный ответ от базы данных или внешнего API |
| 505 | HTTP Version Not Supported | Версия HTTP не поддерживается | Устаревшая конфигурация сервера |
| 507 | Insufficient Storage | Недостаточно места | Переполнен диск хостинга |
Независимо от конкретного кода, причины можно сгруппировать в несколько категорий:
memory_limit), превышено максимальное количество одновременных процессов.Прежде чем исправлять ошибку, нужно понять её причину. Следуйте этому алгоритму:
Логи содержат точное описание ошибки. Расположение зависит от типа сервера:
/var/log/apache2/error.log или /var/log/httpd/error_log/var/log/nginx/error.log/var/log/php-fpm/error.log или /var/log/php7.4-fpm.logwp-config.php: define('WP_DEBUG', true);Ошибка возникает при любом запросе или только на определённых страницах? Если только на конкретных страницах - проблема в коде этих страниц. Если на всём сайте - проблема на уровне сервера.
Используйте команды для мониторинга нагрузки:
Внутренняя ошибка сервера 500 - самый общий код. Сервер понимает, что что-то пошло не так, но не может указать конкретную причину.
Если вы недавно редактировали .htaccess, переименуйте его и проверьте, исчезла ли ошибка:
Если ошибка исчезла - проблема в синтаксисе .htaccess. Создайте новый файл с минимальным набором правил.
Частая причина 500 ошибки - скрипт превысил выделенную память. Добавьте в php.ini, .htaccess или wp-config.php:
Некорректные права могут вызывать 500 ошибку. Стандартные права:
644755600 (для безопасности)Ошибка 502 Bad Gateway означает, что один сервер (например, nginx) получил некорректный ответ от другого сервера (например, PHP-процессора).
Если используется PHP-FPM, перезапустите сервис:
Если nginx работает как прокси для Apache или Node.js, убедитесь, что бэкенд запущен и доступен:
В конфигурации nginx добавьте или измените параметры:
Ошибка 503 Service Unavailable сигнализирует, что сервер временно не может обработать запрос из-за перегрузки или технического обслуживания.
Некоторые CMS (WordPress, Joomla) автоматически переводят сайт в режим обслуживания при обновлении. Если обновление прервалось, сайт может остаться в этом режиме.
Для WordPress: удалите файл .maintenance из корневой директории сайта.
Если сервер не справляется с нагрузкой, увеличьте количество воркеров. Для PHP-FPM отредактируйте конфигурацию пула:
Снизьте нагрузку на сервер с помощью кэширования:
proxy_cache или fastcgi_cacheОшибка 504 Gateway Timeout возникает, когда сервер не получил ответ от вышестоящего сервера за отведённое время.
Если сайт работает с базой данных, медленные запросы - главная причина таймаутов. Включите лог медленных запросов в MySQL:
Синхронизируйте таймауты между nginx, PHP и базой данных:
| Уровень | Параметр | Рекомендуемое значение |
|---|---|---|
| Nginx | proxy_read_timeout |
300s |
| PHP | max_execution_time |
300 |
| PHP-FPM | request_terminate_timeout |
300s |
| MySQL | wait_timeout |
600 |
Для тяжёлых операций (генерация отчётов, отправка писем) используйте очереди: RabbitMQ, Redis Queue, Sidekiq. Это освобождает основной процесс и предотвращает таймауты.
Предотвратить ошибку проще, чем исправлять её в продакшене. Настройте систему мониторинга:
Что мониторить:
error.log)memory_limit PHP до 256Mtop / htopОшибки 4xx указывают на проблему со стороны клиента: неверный адрес (404), нет доступа (403), неавторизован (401). Ошибки 5xx - это всегда проблема сервера: код упал, не хватило ресурсов, таймаут. Пользователь не может исправить 5xx ошибку самостоятельно, это задача администратора сервера или разработчика.
Да, критически влияют. Если поисковый робот получает 5xx при обходе страниц, Яндекс может временно исключить их из индекса. Длительные ошибки (более 24 часов) приводят к падению позиций. Рекомендуется устранять 5xx ошибки в течение 1-2 часов после обнаружения.
Это указывает на проблему в коде конкретной страницы или модуля. Проверьте логи - там будет указан файл и строка, вызвавшая ошибку. Частые причины: конфликт плагинов, ошибка в шаблоне, превышение лимита памяти при обработке данных. Попробуйте отключить плагины по одному, чтобы найти виновника.
502 Bad Gateway - сервер получил некорректный ответ от вышестоящего сервиса (например, PHP-процесс упал). 504 Gateway Timeout - сервер не дождался ответа за отведённое время (например, база данных отвечает слишком долго). Диагностика: 502 часто сопровождается перезагрузкой процессов, 504 - оптимизацией запросов и таймаутов.
Да. Если на виртуальном хостинге (shared) соседний сайт потребляет все ресурсы, ваш сайт может получать 503 ошибки. В этом случае стоит перейти на VPS или выделенный сервер. Также хостер может проводить технические работы - в этом случае 503 ошибка временная и исчезает сама.
Создайте файл 500.html с понятным сообщением и загрузите на сервер. Затем добавьте директиву в конфигурацию: для Apache в .htaccess: ErrorDocument 500 /500.html, для nginx: error_page 500 502 503 504 /50x.html;. Это улучшит пользовательский опыт и покажет, что проблема временная.
Этот код возвращается, когда сервер обнаруживает бесконечный цикл при обработке запроса. Обычно возникает при неправильной настройке WebDAV или при рекурсивных вызовах в коде. Проверьте логи и убедитесь, что нет циклических зависимостей в конфигурации.
5xx ошибки сервера - критичные сбои, которые требуют немедленного реагирования. Начните с диагностики логов, определите конкретный код ошибки и следуйте пошаговым инструкциям для его устранения. Настройте мониторинг и алерты, чтобы узнавать о проблемах до того, как их заметят пользователи. Для большинства случаев достаточно откатить последний деплой, увеличить лимиты памяти и перезапустить сервисы. Если ошибки повторяются регулярно - рассмотрите переход на более производительный хостинг или оптимизацию кода приложения.
Админка WordPress открывалась до 21 секунды, менеджеры испытывали проблемы с редактированием записей. Нашёл избыточную нагрузку WPML и Toolset, устранил ошибки совместимости PHP и исправил шаблон туров. Подробный разбор диагностики и решения.
Переработана структура каталога интернет-магазина на OcStore 1.5.6.4: карточки товаров получили постоянные URL и стабильные хлебные крошки, старые адреса перенаправляются через 301 Redirect, а отдельные товары теперь можно выводить в плитках категорий вместе с подкатегориями.
Пришлите ссылку на сайт и кратко опишите задачу — я посмотрю и предложу следующий шаг.