QNetworkAccessManager不必强制在主线程创建，但必须在其所属线程中使用且该线程需运行事件循环；若在子线程使用，须调用moveToThread()并启动exec()，否则finished()信号不触发；跨线程连接必须用Qt::QueuedConnection确保槽函数在接收者线程执行。
QNetworkAccessManager必须在主线程创建吗
不是必须，但绝大多数情况下应该在主线程创建。Qt文档明确指出 QNetworkAccessManager 的事件循环依赖于其所属线程的 QEventLoop，如果在子线程中使用，必须确保该线程已启动事件循环（比如调用 QThread::exec()），否则信号如 finished() 永远不会触发。
常见错误现象：finished() 信号不发射、请求卡住、reply->isFinished() 始终返回 false。
- 主线程中直接构造：安全、默认可用，推荐用于 GUI 应用中的网络操作
- 子线程中使用：需手动调用
moveToThread()+ 启动事件循环，且不能跨线程调用get()/post() - 全局单例场景：可封装为静态成员或
Q_GLOBAL_STATIC，但注意线程亲和性 —— 它绑定的是首次调用get()的线程
如何正确连接finished()信号并读取响应
必须用 Qt::QueuedConnection 或自动连接（在跨线程时默认生效），否则槽函数可能在子线程中直接执行，导致访问 UI 控件崩溃（如 QLabel::setText()）。
关键点：信号发送者（QNetworkReply*）生命周期短，必须在槽内立即读取数据，或调用 reply->deleteLater()；不能保存裸指针长期使用。
立即学习“C++免费学习笔记（深入）”；
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
- 正确写法：
connect(reply, &QNetworkReply::finished, this, &MyClass::onReplyFinished, Qt::QueuedConnection) - 响应体读取必须在
finished()触发后：先检查reply->error() == QNetworkReply::NoError，再调用reply->readAll() - 忽略
readyRead()：对大多数 HTTP 请求没必要；它适用于流式响应（如长连接 SSE），但需手动管理缓冲区 - 示例片段：
void MyClass::onReplyFinished() { QNetworkReply* reply = qobject_cast<QNetworkReply*>(sender()); if (!reply) return; if (reply->error() == QNetworkReply::NoError) { QByteArray data = reply->readAll(); // 处理 data } reply->deleteLater(); // 必须！ }
POST请求传JSON数据的典型写法
核心是设置两个头：Content-Type 和 Content-Length（后者 Qt 通常自动计算，但显式设更稳妥），且 postData 必须是 QByteArray，不能传 QString 直接转。
容易踩的坑：中文乱码（没指定 UTF-8）、服务器返回 400（JSON 格式错误或 header 缺失）、空响应（忘记调用 reply->readAll()）。
- 构建 JSON：
QJsonDocument doc(jsonObj); QByteArray jsonData = doc.toJson(QJsonDocument::Compact); - 设置头：
request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json; charset=utf-8"); - 发起请求：
manager->post(request, jsonData); - 不要用
QString::toUtf8().data()：会返回临时指针，造成野指针；必须用toUtf8()返回的QByteArray
如何处理重定向、超时和证书错误
默认情况下 QNetworkAccessManager 会自动跟随 HTTP 重定向（301/302），但 HTTPS 证书错误（如自签名）会直接失败，且无默认超时机制 —— 这是最常被忽略的生产问题。
- 禁用自动重定向：
request.setAttribute(QNetworkRequest::RedirectPolicyAttribute, QNetworkRequest::ManualRedirectPolicy); - 实现超时：Qt 5.15+ 支持
request.setTransferTimeout(30000)；旧版本需用QTimer::singleShot()配合reply->abort() - 忽略 SSL 错误（仅调试）：
connect(reply, &QNetworkReply::sslErrors, [](QNetworkReply*, const QList<QSslError>& errors){ for (auto& e : errors) qDebug() << "SSL error:" << e.errorString(); reply->ignoreSslErrors(); // 注意：这行必须在信号槽内调用 }); - 正式环境务必验证证书，不要留
ignoreSslErrors()
实际项目里最麻烦的往往不是发请求，而是确保 reply 对象不泄漏、信号连接方式匹配线程模型、以及超时和错误分支全覆盖 —— 少一个 deleteLater() 或漏一种 QNetworkReply::NetworkError 类型，就可能让程序在特定网络条件下静默失败。
