基于Qt 6.3.0在Android平台搭建HTTPS服务器的技术问询

完全可以基于Qt的核心网络模块（QTcpServer、QSslSocket等）从零实现HTTPS服务器，不需要依赖尚未可用的Qt HTTP Server模块。以下是核心实现思路和起步代码：

核心实现步骤 #

• 基于QTcpServer搭建基础TCP服务，监听指定端口
• 对新接入的TCP连接，升级为QSslSocket并完成SSL握手
• 解析客户端发送的HTTP请求，构造符合HTTPS规范的响应

起步代码示例 #

服务器类头文件（HttpsServer.h） #

#ifndef HTTPSSERVER_H
#define HTTPSSERVER_H

#include <QTcpServer>
#include <QSslSocket>

class HttpsServer : public QTcpServer
{
    Q_OBJECT
public:
    explicit HttpsServer(QObject *parent = nullptr);
    bool startServer(const QHostAddress &address, quint16 port);

private slots:
    void onNewConnection();
    void onSslErrors(const QList<QSslError> &errors);
    void onReadyRead();
    void onSocketDisconnected();

private:
    void setupSslSocket(QSslSocket *socket);
    void sendResponse(QSslSocket *socket, int statusCode, const QString &content);
};

#endif // HTTPSSERVER_H

服务器类实现（HttpsServer.cpp） #

#include "HttpsServer.h"
#include <QSslCertificate>
#include <QSslKey>
#include <QFile>
#include <QTextStream>

HttpsServer::HttpsServer(QObject *parent) : QTcpServer(parent)
{
    connect(this, &QTcpServer::newConnection, this, &HttpsServer::onNewConnection);
}

bool HttpsServer::startServer(const QHostAddress &address, quint16 port)
{
    return listen(address, port);
}

void HttpsServer::onNewConnection()
{
    QTcpSocket *tcpSocket = nextPendingConnection();
    if (!tcpSocket) return;

    QSslSocket *sslSocket = new QSslSocket(this);
    sslSocket->setSocketDescriptor(tcpSocket->socketDescriptor());
    tcpSocket->setParent(nullptr); // 交给sslSocket管理

    setupSslSocket(sslSocket);

    connect(sslSocket, &QSslSocket::sslErrors, this, &HttpsServer::onSslErrors);
    connect(sslSocket, &QIODevice::readyRead, this, &HttpsServer::onReadyRead);
    connect(sslSocket, &QAbstractSocket::disconnected, this, &HttpsServer::onSocketDisconnected);

    sslSocket->startServerEncryption();
}

void HttpsServer::setupSslSocket(QSslSocket *socket)
{
    // 加载自签名证书和私钥（测试用，Android上可将文件放在assets目录）
    QFile certFile(":/cert/server.crt");
    QFile keyFile(":/cert/server.key");
    if (certFile.open(QIODevice::ReadOnly) && keyFile.open(QIODevice::ReadOnly)) {
        QSslCertificate cert(&certFile, QSsl::Pem);
        QSslKey key(&keyFile, QSsl::Rsa, QSsl::Pem);
        socket->setLocalCertificate(cert);
        socket->setPrivateKey(key);
    }
}

void HttpsServer::onSslErrors(const QList<QSslError> &errors)
{
    // 测试环境下可忽略错误，生产环境需处理
    QSslSocket *socket = qobject_cast<QSslSocket*>(sender());
    if (socket) {
        socket->ignoreSslErrors();
    }
}

void HttpsServer::onReadyRead()
{
    QSslSocket *socket = qobject_cast<QSslSocket*>(sender());
    if (!socket) return;

    // 读取HTTP请求（简单实现，仅处理GET请求）
    QByteArray requestData = socket->readAll();
    QString requestStr(requestData);

    // 构造响应
    if (requestStr.startsWith("GET")) {
        QString responseContent = "<html><body><h1>Qt HTTPS Server on Android</h1></body></html>";
        sendResponse(socket, 200, responseContent);
    } else {
        sendResponse(socket, 404, "<html><body><h1>404 Not Found</h1></body></html>");
    }
}

void HttpsServer::sendResponse(QSslSocket *socket, int statusCode, const QString &content)
{
    QByteArray response;
    QTextStream stream(&response);

    stream << "HTTP/1.1 " << statusCode << " " << (statusCode == 200 ? "OK" : "Not Found") << "\r\n";
    stream << "Content-Type: text/html; charset=utf-8\r\n";
    stream << "Content-Length: " << content.toUtf8().size() << "\r\n";
    stream << "\r\n";
    stream << content;

    socket->write(response);
    socket->flush();
    socket->disconnectFromHost();
}

void HttpsServer::onSocketDisconnected()
{
    QSslSocket *socket = qobject_cast<QSslSocket*>(sender());
    if (socket) {
        socket->deleteLater();
    }
}

Android环境注意事项 #

• 权限配置：在AndroidManifest.xml中添加网络权限：

  <uses-permission android:name="android.permission.INTERNET" />
  

• SSL依赖：确保Qt 6.3.0在Android上的SSL模块正常工作，若遇到SSL相关错误，需确认项目已链接Qt6Network模块，且Android环境包含OpenSSL库（Qt 6通常会自带适配版本）。
• 证书路径：将证书和私钥文件添加到Qt项目的资源文件（.qrc）中，或放在Android的assets目录，确保代码中路径正确。

内容的提问来源于stack exchange，提问作者speryem