Что на самом деле означают 403, 404, 500, 502, 503 и 504 на этой платформе и что конкретно делать в каждом случае.
Код ошибки это не общее сообщение о сбое. Он показывает, какой уровень стека дал сбой, и это сильно сужает причину. 502 и 504 выглядят для посетителя одинаково, но имеют совершенно разные причины и способы устранения.
Как узнать настоящий код
Прежде чем начинать диагностику, узнайте реальный номер. Красивая страница ошибки может говорить одно, а сервер возвращать другое.
В браузере откройте инструменты разработчика, перейдите на вкладку Network, перезагрузите страницу и щёлкните по первому запросу. Статус указан в верхней части панели Headers.
В терминале:
curl -sSI https://yourdomain.com/
Это выводит строку статуса и заголовки ответа без загрузки самой страницы. Заголовки важны: несколько случаев ниже определяются именно по заголовку, а не только по коду.
Краткая версия
| Код | Значение | Чья это проблема |
|---|---|---|
| 401 | Требуется аутентификация | Включена Защита паролем |
| 403 | Запрос намеренно отклонён | Правило безопасности заблокировало запрос |
| 404 | Не найдено | Ваш сайт, обычно маршрутизация |
| 500 | Ваше приложение упало | Ваш код или плагин |
| 502 | Сервер за веб-сервером не ответил | Обычно ваше приложение |
| 503 | Сервер намеренно не обслуживает запросы прямо сейчас | Приостановка, пауза или обслуживание |
| 504 | Запрос выполнялся слишком долго | Что-то в вашем коде работает медленно |
401 Unauthorized
Вы увидите окно браузера с запросом имени пользователя и пароля вместо страницы. Это значит, что на сайте или на этом пути включена базовая защита паролем.
Отключите её или получите учётные данные в разделе Веб-сайты, выберите сайт, Параметры, затем Защита паролем. См. Защита паролем.
Продление сертификата продолжает работать, пока включена защита паролем, так что это не нарушит работу вашего HTTPS.
403 Forbidden
403 означает, что что-то намеренно отклонило запрос. На этой платформе есть четыре отдельных источника такого поведения.
Межсетевой экран веб-приложений (WAF). Каждый сайт работает за движком правил, который проверяет входящие запросы и блокирует те, что соответствуют известным шаблонам атак. Это самый частый источник неожиданного 403, и почти всегда это ложное срабатывание на легитимный, но нестандартный запрос: длинная отправка формы, конструктор страниц, сохраняющий сложный контент, плагин, отправляющий необработанный код.
Признаки блокировки межсетевым экраном: одно конкретное действие каждый раз завершается ошибкой 403, при этом остальной сайт работает нормально, и та же ошибка воспроизводится одинаково в другом браузере и в другой сети.
Решение, это точечное исключение из правил, которое может добавить поддержка. Не ищите переключатель, чтобы отключить межсетевой экран целиком: для общего хостинга такого переключателя нет, да и это было бы неверным решением. Откройте тикет с точным URL, точным временем и описанием того, что вы делали. См. Как открыть тикет в службу поддержки.
Геоблокировка. Если вы ограничили доступ к сайту определёнными странами, все остальные получат 403. Проверьте Параметры, затем Безопасность. См. Геоблокировка.
Блокировка IP. Либо та, что вы сами добавили в разделе Security, либо блокировка на уровне платформы из-за злоупотреблений.
Проблема с правами доступа к файлам или символическими ссылками. Встречается реже и обычно проявляется после ручной операции с файлами через SSH.
404 Not Found
Сервер ответил, но по этому адресу ничего нет.
Ошибка 404 на одной странице. Файла или записи действительно не существует, либо URL указан неверно.
Ошибка 404 на всех страницах, кроме главной. Это проблема маршрутизации, и в WordPress это почти всегда постоянные ссылки (permalinks). Важно: веб-хостинг KapsuleHost работает на nginx, а не на Apache, поэтому правила переписывания .htaccess здесь ничего не делают. Если вы переехали с хостинга, который их использовал, вот в чём причина. См. Проблемы с постоянными ссылками и WordPress и .htaccess.
Ошибка 404 на всём сайте. Проверьте, что сайт указывает на правильный корневой каталог документов и что ваш домен привязан к нужному сайту. См. Пользовательский домен для сайта.
Работает на вашем компьютере, но выдаёт 404 на сервере. В Linux регистр букв в именах файлов имеет значение. Logo.PNG и logo.png это два разных файла.
500 Internal Server Error
Ваше приложение запустилось и упало. С веб-сервером всё в порядке, дело в коде.
Это как раз тот случай, когда логи почти сразу дают ответ, потому что фатальная ошибка PHP записывает файл и номер строки, где произошёл сбой, и обычно это прямо указывает на конкретный плагин.
- Перейдите в Веб-сайты, выберите сайт, Параметры, затем Логи.
- Посмотрите самые свежие записи.
- Сопоставьте метку времени со временем, когда вы увидели ошибку.
См. Логи ошибок. Для специфичного для WordPress варианта, когда вместо ошибки отображается пустая страница, см. Белый экран WordPress.
Самые частые причины: несовместимость плагина или темы с вашей версией PHP, достижение лимита памяти и сбой подключения к базе данных. См. Расширения и настройки PHP и Лимит памяти WordPress.
502 Bad Gateway
Веб-сервер попытался передать запрос вашему приложению и не получил ничего пригодного в ответ. Процесс приложения отказал в соединении или завершился посреди обработки запроса.
Частые причины:
- Процесс PHP упал, часто из-за нехватки памяти на одном запросе.
- Приложение на Node.js не запущено или упало при старте.
- Всплеск трафика исчерпал доступные рабочие процессы.
Что делать: сначала проверьте логи, как описано выше. Если это приложение на Node, проверьте, действительно ли процесс запущен, и посмотрите вывод при его старте. Если ошибки 502 появляются только в часы пиковой нагрузки, это проблема нехватки ресурсов, а не ошибка в коде. См. Медленная работа сайта и ограничения ресурсов.
Ошибка 502 от самой KPanel при сохранении настройки означает нечто иное. Это значит, что панель не смогла применить изменение конфигурации к веб-серверу и откатила изменение, вместо того чтобы оставить ваш сайт наполовину настроенным. Ваш сайт при этом не пострадал. Попробуйте ещё раз, и если ошибка повторяется, откройте тикет.
503 Service Unavailable
503 означает, что сервер намеренно не обслуживает запросы прямо сейчас. На этой платформе есть три конкретные причины, и по ответу можно определить, какая именно.
Ваш сайт приостановлен. Вы увидите страницу с заголовком "This site is paused". Это связано с биллингом или состоянием аккаунта, а не с технической неисправностью, и сайт возобновит работу сразу же, как только это состояние будет устранено. Проверьте раздел Биллинг. См. Неудачный платёж и Аккаунт приостановлен.
Обслуживание платформы. Страница обслуживания для всей платформы, что случается редко и всегда анонсируется заранее. Проверьте Статус и доступность.
504 Gateway Timeout
Ваше приложение всё ещё работало, когда у веб-сервера закончилось терпение. Ничего не упало. Просто всё происходило слишком медленно.
Типичные причины:
- Долгий импорт, экспорт, резервное копирование или массовая операция, запущенные через браузер.
- Плагин, обращающийся к медленному внешнему API при каждой загрузке страницы.
- Ресурсоёмкий запрос к базе данных без индекса.
- Задача cron, запускаемая просмотром страницы, а не настоящим cron.
Что делать:
- Определите, какой запрос выполняется медленно. Вкладка APM на сайтах WordPress покажет это. См. Производительность сайта.
- Для длительных операций используйте командную строку, а не браузер. См. WP-CLI.
- Перенесите запланированную работу на настоящий cron. См. Задачи cron.
- Увеличьте
max_execution_time, если работе действительно требуется больше времени, хотя это скорее обходное решение, чем исправление. См. Расширения и настройки PHP.
Обратите внимание на разницу: если PHP первым достигает собственного лимита времени выполнения, вы получите 500, а не 504. Оба кода означают "слишком медленно", но на разных уровнях.
Полное отсутствие ответа
Иногда кода ошибки нет вовсе, потому что нет и самого ответа. Соединение просто зависает и в итоге обрывается по тайм-ауту.
Если это происходит из одной сети, но сайт работает из другой, и особенно если это телефон на мобильном интернете, наиболее вероятная причина, это автоматическая блокировка за злоупотребления: всплеск ошибок или неудачных попыток входа с вашего адреса вызвал временный запрет на уровне сети. Такие блокировки снимаются сами, обычно в течение часа. Если нужно снять её раньше, свяжитесь с поддержкой и укажите IP-адрес, с которого вы подключаетесь.
Пользовательские страницы ошибок
Вы можете заменить стандартную страницу ошибки для 400, 401, 403, 404, 500, 502, 503 и 504 на собственный HTML в разделе Веб-сайты, выберите сайт, Параметры, затем Страницы ошибок. KapsuleHost предоставляет фирменные страницы по умолчанию для 404, 500, 502, 503 и 504, если вы не настроили свои.
Стоит знать одну вещь: пользовательская страница ошибки сохраняет настоящий код статуса. Пользовательская страница 404 всё равно возвращает 404. Отдача вашей страницы ошибки со статусом 200, это классический способ разрушить позиции сайта в поиске, и здесь это намеренно невозможно. См. Пользовательские страницы ошибок.