Evgenii Legotckoi
Evgenii LegotckoiMay 4, 2017, 11:33 a.m.

Qt/C++ - Lesson 065. The correspondence of HTTP errors to server response errors in QNetworkAccessManager

In one of the lessons, I worked with QNetworkAccessManager to get the content of the page from the site via the http protocol. There was made a check for errors, but no explanation was given as to what errors might be. For this, the QNetworkReply class provides an enum NetworkError , which lists the possible error codes.

If successful, NoError is returned, which is 0.

Otherwise, an error code is returned from the codes below:

Constant Value Description
the remote server refused the connection (the server is not accepting requests)
the remote server closed the connection prematurely, before the entire reply was received and processed
the remote host name was not found (invalid hostname)
the connection to the remote server timed out
the operation was canceled via calls to abort() or close() before it was finished.
the SSL/TLS handshake failed and the encrypted channel could not be established. The sslErrors() signal should have been emitted.
the connection was broken due to disconnection from the network, however the system has initiated roaming to another access point. The request should be resubmitted and will be processed as soon as the connection is re-established.
the connection was broken due to disconnection from the network or failure to start the network.
the background request is not currently allowed due to platform policy.
while following redirects, the maximum limit was reached. The limit is by default set to 50 or as set by QNetworkRequest::setMaxRedirectsAllowed(). (This value was introduced in 5.6.)
while following redirects, the network access API detected a redirect from a encrypted protocol (https) to an unencrypted one (http). (This value was introduced in 5.6.)
the connection to the proxy server was refused (the proxy server is not accepting requests)
the proxy server closed the connection prematurely, before the entire reply was received and processed
the proxy host name was not found (invalid proxy hostname)
the connection to the proxy timed out or the proxy did not reply in time to the request sent
the proxy requires authentication in order to honour the request but did not accept any credentials offered (if any)
the access to the remote content was denied (similar to HTTP error 401)
the operation requested on the remote content is not permitted
the remote content was not found at the server (similar to HTTP error 404)
the remote server requires authentication to serve the content but the credentials provided were not accepted (if any)
the request needed to be sent again, but this failed for example because the upload data could not be read a second time.
the request could not be completed due to a conflict with the current state of the resource.
the requested resource is no longer available at the server.
the server encountered an unexpected condition which prevented it from fulfilling the request.
the server does not support the functionality required to fulfill the request.
the server is unable to handle the request at this time.
the Network Access API cannot honor the request because the protocol is not known
the requested operation is invalid for this protocol
an unknown network-related error was detected
an unknown proxy-related error was detected
an unknown error related to the remote content was detected
a breakdown in protocol was detected (parsing error, invalid or unexpected responses, etc.)
an unknown error related to the server response was detected

After studying this list of errors, we can conclude that this list combines a much larger list of errors than, for example, the list of error codes that the http server can return. Let's talk a little about possible errors and because of what they can arise.

QNetworkReply::ConnectionRefusedError and QNetworkReply::RemoteHostClosedError

If we talk about the interpretation of these errors, then the most striking example for me is connecting via SSH to another host. The meaning of the errors is that in the first case the server does not allow us, and in the second case the connection could be closed after a certain period of time.

Also, the ConnectionRefusedError error can occur when there is simply no service on a particular PC port that could process the request.


Perhaps a fairly understandable error, which means that you just typed the wrong ip address or domain from which you are trying to get data. Also, this error can occur if the domain has ceased to be available on the network. This error is similar to error number 105 - ERR_NAME_NOT_RESOLVED (HTTP).


The waiting interval is exceeded. The closest comparison is the use of the ICMP protocol, checking the availability of the node on the network when we make it ping. That is, there is a node in the network, but it does not respond.


And here is an error that already applies to the actions of the program itself on Qt. In this case, it will occur when the program logic stops receiving data through the QNetworkAccessManager . That is, this error should not occur if the data receiving operation was interrupted from the outside. Therefore, if you catch such a mistake, then look for a problem inside your own program.


To establish encrypted communication channels that use SSL encryption, it is required to establish a connection through acknowledgment operations, that is, through acknowledgment of the reception / transmission of information. In this case, the encryption parameters are negotiated, the session key is transmitted, as well as optional server authentication operations by the client and the client by the server. If any of the above goes wrong, then this error will be thrown out.

QNetworkReply::TemporaryNetworkFailureError and QNetworkReply::NetworkSessionFailedError

The occurrence of these errors can be caused by any network problem until the physical connection to the network falls. You can check connections through the QNetworkInterface class.

The QNetworkInterface class has a static QList QNetworkInterface::allInterfaces() method that returns a list of all interfaces on your PC. This will take into account absolutely all connections, up to the connections that were created for the virtual machine, for example, for the Virtual Box . Here, by the way, there is a very interesting moment when software is being developed that should work on the network, and at the same time the developer has a virtual machine on board, especially if it is running, then this should be taken into account, because the program can try to get data through the connection With a virtual machine, that is, it will assume that the network is available, although the developer will test the User Case with the connection disconnected. However, even a disabled virtual machine will cause some problems, since the connection will be active, although Link will not be raised.

Therefore, to understand what's wrong, when you receive QNetworkReply::TemporaryNetworkFailureError and QNetworkReply::NetworkSessionFailedError errors, you will have to test the PC interfaces for activity: QNetworkInterface::IsUp and QNetworkInterface::IsRunning .


But this error depends directly on the policies of the platform for which the application is developed. For example, if some abstract Android device prohibits the exchange of information on the network in an energy-saving mode, then in this mode we will receive this error when trying to exchange information.

QNetworkReply::TooManyRedirectsError and QNetworkReply::InsecureRedirectError

But these errors from the category of new in Qt 5.6. Now you can monitor the excess of the number of redirects from site pages, as well as redirects from pages with https encryption to pages without encryption. What can be useful for developing software for website analysis.

Without additional settings, these errors usually do not occur. The point is that when QNetworkRequest is set and configuration flags are not set, then when you try to request a page from the site from which the redirect is done, there will be no transition to the new url, and QNetworkReply will not have any useful content. Therefore, you will need to set the QNetworkRequest flag in the QNetworkRequest::FollowRedirectsAttribute , then QNetworkAccessManager will go through the redirects until it receives the summary page or exceeds the limit on the number of transitions. By default, the number of transitions is limited to 50th.

The attribute can be set as follows:

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

As for QNetworkReply::InsecureRedirectError , the point is to track the redirect to an unsafe protocol.

Errors of QNetworkReply::Proxy*

The following five errors are similar in nature to server connection errors without proxying.


The documentation says that this error is similar to the 401 error in HTTP, that is, authorization is required, but I believe that this error can also occur in cases of receiving codes 403 and 407. Error 407 is similar to error 401, but is used for a proxy server. And error 403 is generative for errors 401 and 407.


This error is specific to the HTTP protocol. The fact is that the http protocol supports authentication schemes. In this case it is necessary to send a request to the server with the setting of login and password. Note that this directly means that you can write an application on Qt that will be authenticated on sites and perform certain actions on the site already in authorized mode, that is, you can write and bot to work on the site.

The solution to this problem is to set the user's login and password in QAuthenticator, which will mix the credentials to the request. And this will be done in automatic mode at the signal QNetworkAccessManager::authenticationRequired , and the login and password will be cached, so the signal will not be emitted at each request.

        [this](QNetworkReply *rep, QAuthenticator* auth){


It is difficult to make any exact analogy with the HTTP codes for this error, since it can be caused by various reasons.


This error corresponds to a 409 Conflict error in the HTTP protocol.


This error corresponds to a 410 Gone error in the HTTP protocol.


This error corresponds to 500 Internal Server Error in the http protocol.


This error corresponds to a 501 Not Implemented error in the http protocol. It occurs when you try to execute, for example, a POST request to a URL where the server processes only GET requests.

This behavior can be found, for example, in the Django project. If the query is not implemented, the server with Django will send a blank page to the POST request with this code.


An error such as QNetworkReply::ProtocolUnknownError can occur because a url was passed to the request without specifying the protocol type, that is, instead of


Was transferred


This problem can arise if you parse the pages and extract the url of the images. For example, on this site the addresses of all images in the articles are as follows


That is, the protocol and domain of the site are not specified. Therefore, if you extract all image URLs from a page, you will not be able to download images without additional processing, namely without the domain and protocol substitution at the beginning of the line, having received this error.


Corresponds to the error 503 Service Unavailable in the http protocol


In this case, the protocol is defined, but the exact correspondence of the error from the http protocol is not traced, with respect to other protocols, it can also be anything.


The most common variant of what this error may correspond to is the 502 Bad Gateway error  in the http protocol


There may also be a 502 error, but already in the version with a proxy server

Errors QNetworkReply::UnknownContentError,QNetworkReply::ProtocolFailure, QNetworkReply::UnknownServerError

With these errors, I find it difficult to find a working correspondence, I will be glad to help if anyone has encountered.

Example with error output in qDebug

You can check for an error when the request is terminated from the QNetworkAccessManager in the slot that is connected to process the result of the request.

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

In this case, there is a wrapper class over the QNetworkAccessManager class named Downloader . This class has an onResult slot, which in turn is responsible for processing the result of the QNetworkAccessManager response.

void Downloader::onResult(QNetworkReply *reply)
    // If an error occurred while receiving the data
        // We inform you about this and show information about errors
        qDebug() << "ERROR";
        // Here we get one of the enum NetworkError, that is, the error code
        qDebug() << reply->error();
    } else {
        // ToDo something
We recommend hosting TIMEWEB
We recommend hosting TIMEWEB
Stable hosting, on which the social network EVILEG is located. For projects on Django we recommend VDS hosting.

Do you like it? Share on social networks!

  • May 5, 2017, 9:52 a.m.

Unable to init SSL Context: Выдает приложение, что это может быть?

Evgenii Legotckoi
  • May 5, 2017, 11:19 a.m.

OpenSSL библиотеки возможно требуются. В этой статье есть ссылки, где скачать библиотеки OpenSSL.


Only authorized users can post comments.
Please, Log in or Sign up
  • ehot
  • March 31, 2024, 9:29 p.m.

C++ - Тест 003. Условия и циклы

  • Result:78points,
  • Rating points2

C++ - Test 002. Constants

  • Result:16points,
  • Rating points-10

C++ - Test 001. The first program and data types

  • Result:46points,
  • Rating points-6
Last comments
kmssrFeb. 9, 2024, 2:43 a.m.
Qt Linux - Lesson 001. Autorun Qt application under Linux как сделать автозапуск для флэтпака, который не даёт создавать файлы в ~/.config - вот это вопрос ))
Qt WinAPI - Lesson 007. Working with ICMP Ping in Qt Без строки #include <QRegularExpressionValidator> в заголовочном файле не работает валидатор.
EVADec. 25, 2023, 6:30 p.m.
Boost - static linking in CMake project under Windows Ошибка LNK1104 часто возникает, когда компоновщик не может найти или открыть файл библиотеки. В вашем случае, это файл libboost_locale-vc142-mt-gd-x64-1_74.lib из библиотеки Boost для C+…
JonnyJoDec. 25, 2023, 4:38 p.m.
Boost - static linking in CMake project under Windows Сделал всё по-как у вас, но выдаёт ошибку [build] LINK : fatal error LNK1104: не удается открыть файл "libboost_locale-vc142-mt-gd-x64-1_74.lib" Хоть убей, не могу понять в чём дел…
GvozdikDec. 19, 2023, 5:01 a.m.
Qt/C++ - Lesson 056. Connecting the Boost library in Qt for MinGW and MSVC compilers Для решения твой проблемы добавь в файл .pro строчку "LIBS += -lws2_32" она решит проблему , лично мне помогло.
Now discuss on the forum
a_vlasovApril 14, 2024, 1:41 p.m.
Мобильное приложение на C++Qt и бэкенд к нему на Django Rest Framework Евгений, добрый день! Такой вопрос. Верно ли следующее утверждение: Любое Android-приложение, написанное на Java/Kotlin чисто теоретически (пусть и с большими трудностями) можно написать и на C+…
Павел Дорофеев
Павел ДорофеевApril 14, 2024, 9:35 a.m.
QTableWidget с 2 заголовками Вот тут есть кастомный QTableView с многорядностью проект поддерживается, обращайтесь
Mind minglesApril 12, 2024, 7:42 a.m.
ASO Service Forum: Enhancing App Visibility and Reach Welcome to the ASO Service Forum, your ultimate destination for insights, discussions, and strategies revolving around App Store Optimization. ASO (App Store Optimization) is paramoun…
fastrexApril 4, 2024, 11:47 a.m.
Вернуть старое поведение QComboBox, не менять индекс при resetModel Добрый день! У нас много проектов в которых используется QComboBox, в версии 5.5.1, когда модель испускает сигнал resetModel, currentIndex не менялся. В версии 5.15 при resetModel происходит try…

Follow us in social networks