WebAssembly编译Qt客户端遇QNetworkReply::ProtocolFailure问题求助

核心原因分析 #

这个问题本质是WebAssembly（WASM）环境下，Qt网络请求受浏览器安全规则和自身实现限制，和桌面端的宽松处理逻辑不同——哪怕Wireshark抓到完整的请求与响应，只要协议细节不规范，就会触发QNetworkReply::ProtocolFailure。具体问题点有三个：

1. CORS响应头拼写错误 #

服务器OPTIONS路由里的Access-Control-Allow-Method是单数，正确的头名应为复数Access-Control-Allow-Methods。拼写错误会导致浏览器不认可CORS配置，WASM端的请求被浏览器拦截后，Qt直接返回协议错误。

2. 响应缺少明确的Content-Type #

服务器返回的"TEST REPLY"未设置Content-Type头，桌面端Qt可以自动推断内容类型，但WASM环境下QNetworkAccessManager对HTTP响应格式要求更严格，缺少该头会被判定为协议不符合规范。

3. GET请求携带请求体 #

客户端调用manager->get(req, "Test")时传递了请求体参数，但HTTP规范中GET请求通常不携带请求体，浏览器环境下会对这种不符合规范的请求做特殊处理，最终导致Qt解析响应时出错。

额外隐性问题 #

服务器监听的IP是192.168.86.48，但客户端请求的是192.168.0.84，这会导致请求根本无法到达目标服务器，先修正IP一致性才能继续排查。

具体修复步骤 #

修复服务器代码（mainwindow.cpp） #

修正CORS头拼写，补充Content-Type：

hServer.route("/", QHttpServerRequest::Method::Options, []()
{
    QHttpServerResponse res(QHttpServerResponse::StatusCode::NoContent);
    res.addHeader("Allow", "*");
    res.addHeader("Access-Control-Allow-Origin", "*");
    res.addHeader("Access-Control-Allow-Language", "*");
    res.addHeader("Access-Control-Allow-Encoding", "*");
    // 修正为复数形式
    res.addHeader("Access-Control-Allow-Methods", "*");
    res.addHeader("Access-Control-Allow-Headers", "*");
    return res;
});

hServer.route("/", QHttpServerRequest::Method::Get, []()
{
    QString testAnswer = "TEST REPLY";
    QHttpServerResponse res(testAnswer, QHttpServerResponse::StatusCode::Ok);
    // 添加明确的内容类型头
    res.addHeader("Content-Type", "text/plain; charset=utf-8");
    return res;
});

修复客户端代码（mainwindow.cpp） #

1. 修正请求IP，与服务器监听地址一致：

// 替换为服务器实际监听的IP
QUrl contAdress(QString("http://192.168.86.48:%1").arg(NETWORK_PORT_SERVER));

2. 去掉GET请求的多余请求体参数：

// 原代码：manager->get(req, "Test");
// 修改为：
manager->get(req);

验证方法 #

1. 重新编译服务器和WASM客户端
2. 打开浏览器开发者工具（F12），查看Network标签页：确认CORS头正确、响应包含Content-Type
3. 检查客户端调试输出，确认错误码消失，能正常读取"TEST REPLY"内容

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