Qt/C++ - Урок 065. Соответствие ошибок HTTP ошибкам ответа сервера в QNetworkAccessManager

QNetworkReply, QNetworkError, QNetworkAccessManager

В одном из уроков была представлена работа с QNetworkAccessManager для получения содержимого страницы с сайта по протоколу http. Там была сделана проверка на наличие ошибок, но не были даны пояснения, какие могут быть ошибки. Для этого класс QNetworkReply предоставляет enum NetworkError , в котором перечислены коды возможных ошибок.

В случае успешного выполнения возвращается NoError , равный 0 .

В противном случае возвращается код ошибки из кодов, представленных ниже:

QNetworkReply::ConnectionRefusedError

1

QNetworkReply::RemoteHostClosedError

2

QNetworkReply::HostNotFoundError

3

QNetworkReply::TimeoutError

4

QNetworkReply::OperationCanceledError

5

QNetworkReply::SslHandshakeFailedError

6

QNetworkReply::TemporaryNetworkFailureError

7

QNetworkReply::NetworkSessionFailedError

8

QNetworkReply::BackgroundRequestNotAllowedError

9

QNetworkReply::TooManyRedirectsError

10

QNetworkReply::InsecureRedirectError

11

QNetworkReply::ProxyConnectionRefusedError

101

QNetworkReply::ProxyConnectionClosedError

102

QNetworkReply::ProxyNotFoundError

103

QNetworkReply::ProxyTimeoutError

104

QNetworkReply::ProxyAuthenticationRequiredError

105

QNetworkReply::ContentAccessDenied

201

QNetworkReply::ContentOperationNotPermittedError

202

QNetworkReply::ContentNotFoundError

203

QNetworkReply::AuthenticationRequiredError

204

QNetworkReply::ContentReSendError

205

QNetworkReply::ContentConflictError

206

QNetworkReply::ContentGoneError

207

QNetworkReply::InternalServerError

401

QNetworkReply::OperationNotImplementedError

402

QNetworkReply::ServiceUnavailableError

403

QNetworkReply::ProtocolUnknownError

301

QNetworkReply::ProtocolInvalidOperationError

302

QNetworkReply::UnknownNetworkError

99

QNetworkReply::UnknownProxyError

199

QNetworkReply::UnknownContentError

299

QNetworkReply::ProtocolFailure

399

QNetworkReply::UnknownServerError

499

После изучения данного списка ошибок можно сделать вывод, что данный список объединяет в себе значительно больший список ошибок, чем, например, тот список кодов ошибок, который может вернуть http сервер. Давайте поговорим немного о возможных ошибках и из-за чего они могут возникнуть.

QNetworkReply::ConnectionRefusedError и QNetworkReply::RemoteHostClosedError

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

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

QNetworkReply::HostNotFoundError

Пожалуй довольно понятная ошибка, которая обозначает, что вы просто ввели неверный ip адрес или домен, с которого пытаетесь получить данные. Также, такая ошибка может возникнуть в том случае, если домен перестал быть доступен в сети. Данная ошибка аналогична ошибке номер 105 - ERR_NAME_NOT_RESOLVED (HTTP).

QNetworkReply::TimeoutError

Превышен интервал ожидания. Наиболее близкое сравнение - это использование протокола ICMP, проверка доступности узла в сети, когда производим его ping. То есть узел в сети вроде бы и есть, но он не отвечает.

QNetworkReply::OperationCanceledError

А вот ошибка, которая будет относится уже к действиям самой программы на Qt. В данном случае она будет возникать тогда, когда логика программы прерывает получение данных через QNetworkAccessManager. То есть данная ошибка не должна возникать в том случае, если операция получения данных была прервана извне. Поэтому, если Вы отлавливаете подобную ошибку, то ищите проблему внутри вашей собственной программы.

QNetworkReply::SslHandshakeFailedError

Для установления шифрованных каналов связи, которые используют SSL шифрование, требуется установка соединения через операции квитирования, то есть через подтверждение приёма/передачи информации. В данном случае осуществляется согласование параметров шифрования, передача сеансового ключа, а также необязательные операции аутентификации сервера клиентом и клиента сервером. Если что-то из перечисленного пойдёт не так, то будет выброшена данная ошибка.

QNetworkReply::TemporaryNetworkFailureError и QNetworkReply::NetworkSessionFailedError

Возникновение данных ошибок может быть вызвано любой неполадкой в сети вплоть до падения физического подключения к сети. Проверять подключения можно через класс QNetworkInterface.

Класс QNetworkInterface имеет статический метод QList QNetworkInterface::allInterfaces() , который возвращает список всех интерфейсов на вашем ПК. При этом будут учитываться абсолютно все соединения, вплоть до соединений, которые были созданы для виртуальной машины, например, для Virtual Box. Тут к слову возникает очень интересный момент, когда ведётся разработка программного обеспечения, которое должно работать по сети, и при этом у разработчика имеется виртуальная машина на борту, особенно если она запущена, то необходимо учитывать этот момент, поскольку программа может пытаться получить данные через соединение с виртуальной машиной, то есть будет считать что сеть доступна, хотя разработчик будет тестировать User Case при отключённом соединении. Впрочем, даже выключенная виртуальная машина будет вызывать некоторые проблемы, поскольку соединение будет активно, хотя Link и не будет поднят.

Поэтому, чтобы понять, что не так, при получении ошибок QNetworkReply::TemporaryNetworkFailureErro r и QNetworkReply::NetworkSessionFailedError придётся протестировать интерфейсы ПК на предмет активности: QNetworkInterface::IsUp и QNetworkInterface::IsRunning.

QNetworkReply::BackgroundRequestNotAllowedError

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

QNetworkReply::TooManyRedirectsError и QNetworkReply::InsecureRedirectError

А вот эти ошибки из разряда новенького в Qt 5.6. Теперь можно отслеживать превышения количества редиректов со страниц сайтов, а также редиректы со страниц с шифрованием https на страницы без шифрования. Что может быть полезно для разработки программного обеспечения для анализа сайтов.

Без дополнительных настроек данные ошибки как правило не возникают. Дело в том, что когда задаётся QNetworkRequest и в него не устанавливаются флаги конфигурации, то при попытке запроса страницы с сайта, с которой осуществляется редирект, не будет происходить перехода на новый url, а в QNetworkReply не будет никакого полезного контента. Поэтому потребуется установить в QNetworkRequest флаг QNetworkRequest::FollowRedirectsAttribute, тогда QNetworkAccessManager будет переходить по редиректам, пока не получит итоговую страницу или не превысит ограничение на количество переходов. По умолчанию количество переходов ограничено 50-ю.

Установка атрибута может производиться следующим образом:

QNetworkRequest request;  
request.setAttribute(QNetworkRequest::FollowRedirectsAttribute, QVariant(true));

Что касается QNetworkReply::InsecureRedirectError, то смысл заключается в том, чтобы отследить редирект на небезопасный протокол.

Ошибки QNetworkReply::Proxy*

Следующие пять ошибок аналогичны по своему характеру ошибкам подключения к серверам без проксирования.

QNetworkReply::ContentAccessDenied

В документации сказано, что данная ошибка аналогична ошибке 401 в HTTP, то есть требуется авторизация, но полагаю, что данная ошибка может возникать и в случаях получения кода 403 и 407. Ошибка 407 аналогична ошибке 401, но используется для прокси-сервера. А ошибка 403 является порождающей для ошибок 401 и 407.

QNetworkReply::AuthenticationRequiredError

Данная ошибка характерна для HTTP протокола. Дело в том, что http протокол поддерживает схемы проверки подлинности. В данном случае необходимо посылать запрос на сервер с установкой логина и пароля. Замечу, что это напрямую означает то, что Вы можете написать приложение на Qt, которое будет аутентифицироваться на сайтах и выполнять определённые действия на сайте уже в авторизованном режиме, то есть можно написать и бота для работы на сайте.

Решение проблемы заключается в том, чтобы установить логин и пароль пользователя в  QAuthenticator, который будет подмешивать учётные данные к запросу. Причем делаться это будет в автоматическом режиме по сигналу QNetworkAccessManager::authenticationRequired, при этом логин и пароль будут кешированы, так что сигнал не будет испускаться при каждом запросе.

connect(&m_manager,&QNetworkAccessManager::authenticationRequired,
        [this](QNetworkReply *rep, QAuthenticator* auth){
            auth->setUser("username");
            auth->setPassword("passwordd");
        });

QNetworkReply::ContentReSendError

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

QNetworkReply::ContentConflictError

Данная ошибка соответствует ошибке 409 Confilct в протоколе HTTP.

QNetworkReply::ContentGoneError

Данная ошибка соответствует ошибке 410 Gone (Удалён) в протоколе HTTP.

QNetworkReply::InternalServerError

Данная ошибка соответствует ошибке 500 Internal Server Error (Внутренняя ошибка сервера) в протоколе http.

QNetworkReply::OperationNotImplementedError

Данная ошибка соответствует ошибке 501 Not Implemented (Не реализовано) в протоколе http. Возникает такая тогда, когда Вы пытаетесь выполнить, например, запрос POST к URL, по которому сервер обрабатывает только GET запросы.

Такое поведение можно встретить, например, в Django проекте. Если запрос не реализован, то сервер с Django отправит пустую страницу на POST запрос с данным кодом.

QNetworkReply::ProtocolUnknownError

Такая ошибка, как QNetworkReply::ProtocolUnknownError, может возникнуть из-за того, что в запрос был передан url без указания типа протокола, то есть вместо

http://www.example.com

было передано

//www.example.com

Такая проблема может возникнуть в том случае, если вы парсите страницы и извлекаете url изображений. Например, на данном сайте адреса всех изображений в статьях выглядят следующим образом

/media/uploads/2017/02/03/testquickwidget.jpg

То есть не указывается протокол и домен сайта. Поэтому если Вы извлечёте все адреса изображений со страницы, то не сможете скачать изображения без дополнительной обработки, а именно без подстановки домена и протокола в начале строки, получив данную ошибку.

QNetworkReply::ServiceUnavailableError

Соответствует ошибке 503 Service Unavailable («сервис недоступен») в протоколе http

QNetworkReply::ProtocolInvalidOperationError

В данном случае протокол определён, но точное соответствие ошибке из протокола http не прослеживается, относительно других протоколов также может быть что угодно.

QNetworkReply::UnknownNetworkError

Наиболее частый вариант того, чему может соответствовать данная ошибка является ошибка шлюза 502 Bad Gateway («плохой, ошибочный шлюз») в протоколу http

QNetworkReply::UnknownProxyError

Также может быть ошибка 502, но уже в варианте с прокси-сервером

Ошибки QNetworkReply::UnknownContentError,QNetworkReply::ProtocolFailure, QNetworkReply::UnknownServerError

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

Пример с выводом ошибки в qDebug

Можно проверять ошибку по сигналу завершения запроса от QNetworkAccessManager в слоте, который подключается для обработки результата запроса.

manager = new QNetworkAccessManager(this);
connect(manager, &QNetworkAccessManager::finished, this, &Downloader::onResult);

В данном случае имеется класс-обёртка над классом QNetworkAccessManager с названием Downloader . У этого класса имеется слот onResult , который в свою очередь отвечает за обработку результата ответа QNetworkAccessManager .

void Downloader::onResult(QNetworkReply *reply)
{
    // Если в процессе получения данных произошла ошибка
    if(reply->error()){
        // Сообщаем об этом и показываем информацию об ошибках
        qDebug() << "ERROR";
        // Здесь получаем один из enum NetworkError, то есть код ошибки
        qDebug() << reply->error();
    } else {
        // ToDo something
    }
}