En esta página

Cambios en Qt Network

Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco de trabajo sea más eficiente y fácil de usar.

Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables en nuestro afán por hacer de Qt un marco de trabajo mejor.

En este tema resumimos esos cambios en Qt Network y ofrecemos orientación para gestionarlos.

Cambios en las API

Sobrecargas de nombres ambiguas

Se han eliminado varias funciones sobrecargadas ambiguas. La señal error() se sustituye por errorOccurred() en QAbstractSocket y sus herederas (QTcpSocket, QUdpSocket, QLocalSocket y QSslSocket), así como en QNetworkReply. Por lo tanto, un código como:

connect(socket, qOverload<QAbstractSocket::SocketError>(&QAbstractSocket::error),
        this, &SomeClass::errorSlot);

debe modificarse, por lo tanto, por:

connect(socket, &QAbstractSocket::errorOccurred, this, &SomeClass::errorSlot);

En QSslSocket, la función que devuelve una lista de los errores detectados durante el protocolo de enlace TLS:

QList<QSslError> sslErrors() const;

pasa a llamarse sslHandshakeErrors():

const auto tlsErrors = socket.sslHandshakeErrors();

Se elimina la gestión de portadores

Las clases QNetworkConfiguration y QNetworkConfigurationManager se han eliminado en Qt 6. En consecuencia, también se han eliminado las siguientes funciones miembro de QNetworkAccessManager:

void setConfiguration(const QNetworkConfiguration &config);
QNetworkConfiguration configuration() const;
QNetworkConfiguration activeConfiguration() const;
void setNetworkAccessible(NetworkAccessibility accessible);
NetworkAccessibility networkAccessible() const;
void networkSessionConnected();

QNetworkInformation, introducida inicialmente en Qt 6.1, tiene como objetivo sustituir algunos aspectos de la API de gestión de portadores. Funciona proporcionando una API unificada que se suscribe a los cambios en la red tal y como los notifica el sistema operativo.

QNetworkInformation::reachability(), introducida en Qt 6.1, sustituye a la función QNetworkAccessManager::networkAccessible(), al tiempo que añade información más detallada sobre la accesibilidad de la red. Consulta su documentación para obtener más detalles.

En Qt 6.2, QNetworkInformation ha incorporado la capacidad de detectar portales cautivos.

En Qt 6.3, ` QNetworkInformation ` incorporó ` QNetworkInformation::transportMedium()` y ` QNetworkInformation::isMetered()`.

Enumeradores eliminados

Se han eliminado varios enumeradores en QtNetwork. Esto incluye constantes para protocolos y funcionalidades que ya no son compatibles:

  • QSsl::SslV2;
  • QSsl::SslV3;
  • QSsl::TlsV1SslV3;
  • QNetworkRequest::SpdyAllowedAttribute;
  • QNetworkRequest::SpdyWasUsedAttribute;
  • QNetworkAccessManager::AccesibilidadDesconocida;
  • QNetworkAccessManager::No accesible;
  • QNetworkAccessManager::Accessible

y enumeradores cuyos nombres no seguían las convenciones de nomenclatura adecuadas:

QNetworkRequest::FollowRedirectsAttribute se ha eliminado en Qt 6; consulta la sección sobre la gestión de redireccionamientos más abajo.

Configuración de QSslSocket

Las siguientes funciones obsoletas se han eliminado en Qt 6:

QList<QSslCipher> ciphers() const;
void setCiphers(const QList<QSslCipher> &ciphers);
void setCiphers(const QString &ciphers);
static void setDefaultCiphers(const QList<QSslCipher> &ciphers);
static QList<QSslCipher> defaultCiphers();
static QList<QSslCipher> supportedCiphers();
QList<QSslCipher> ciphers() const;
void setCiphers(const QList<QSslCipher> &ciphers);
void setCiphers(const QString &ciphers);
static void setDefaultCiphers(const QList<QSslCipher> &ciphers);
static QList<QSslCipher> defaultCiphers();
static QList<QSslCipher> supportedCiphers();
bool addCaCertificates(const QString &path, QSsl::EncodingFormat format = QSsl::Pem,
                       QRegExp::PatternSyntax syntax = QRegExp::FixedString);
void addCaCertificate(const QSslCertificate &certificate);
void addCaCertificates(const QList<QSslCertificate> &certificates);
void setCaCertificates(const QList<QSslCertificate> &certificates);
QList<QSslCertificate> caCertificates() const;
static bool addDefaultCaCertificates(const QString &path, QSsl::EncodingFormat format = QSsl::Pem,
                                     QRegExp::PatternSyntax syntax = QRegExp::FixedString);
static void addDefaultCaCertificate(const QSslCertificate &certificate);
static void addDefaultCaCertificates(const QList<QSslCertificate> &certificates);
static void setDefaultCaCertificates(const QList<QSslCertificate> &certificates);
static QList<QSslCertificate> defaultCaCertificates();
static QList<QSslCertificate> systemCaCertificates();

Utiliza QSslConfiguration y sus funciones miembro para configurar estos parámetros, por ejemplo:

auto sslConfiguration = QSslConfiguration::defaultConfiguration();
sslConfiguration.setCiphers("ECDHE-ECDSA-AES256-SHA384");
// Set other parameters here ...
socket.setSslConfiguration(sslConfiguration);

Cambios en el comportamiento predeterminado de QNetworkAccessManager

Políticas de redireccionamiento

En Qt 6, la política de redireccionamiento predeterminada ha cambiado de «manual» a « QNetworkRequest::NoLessSafeRedirectPolicy ». Si tu aplicación depende de la gestión manual de redireccionamientos (es decir, conecta su slot a la señal « QNetworkReply::redirected »), debes establecer explícitamente esta política al crear una solicitud:

request.setAttribute(QNetworkRequest::RedirectPolicyAttribute, QNetworkRequest::ManualRedirectPolicy);

HTTP/2 está habilitado por defecto

En Qt 6, QNetworkAccessManager habilita el protocolo HTTP/2 de forma predeterminada. Dependiendo del esquema («https» o «http»), QNetworkAccessManager utilizará la extensión TLS de negociación de protocolo en la capa de aplicación o el encabezado HTTP «protocol upgrade» para negociar HTTP/2. Si no se puede negociar HTTP/2, el gestor de acceso recurrirá a HTTP/1.1. Si tu aplicación solo puede utilizar HTTP/1.1, debes desactivar HTTP/2 manualmente en una nueva solicitud:

request.setAttribute(QNetworkRequest::Http2AllowedAttribute, false);

QNetworkAccessManager ahora protege contra las «bombas de archivos»

A partir de Qt 6.2, ` QNetworkAccessManager ` protegerá contra archivos comprimidos que, al descomprimirse, se convierten en archivos mucho más grandes que su forma comprimida, devolviendo un error en la respuesta si la relación de descompresión supera un umbral determinado. Esta comprobación solo se aplica a archivos de un tamaño superior a un límite determinado, que se puede personalizar (o desactivar pasando -1) llamando a ` QNetworkRequest::setDecompressedSafetyCheckThreshold()`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.