05-常见问题
常见问题
Q: 发送 HTTPS 请求时提示 SSL 错误？
- 可能原因：
- 目标服务器使用自签名证书
- 系统时间不正确导致证书过期判断错误
- 防火墙或代理拦截了 SSL 连接
- 解决方案：
- 检查系统时间是否正确
- 如果服务器使用自签名证书，可将证书导入 Windows 受信任的根证书颁发机构
- 如果是公司内网环境，可能需要配置代理
Q: 为什么 Body 编辑区是灰色的不能输入？
当选择 GET 或 HEAD 方法时，Body 编辑区会自动禁用。这是因为 HTTP 规范中 GET 和 HEAD 请求不应携带请求体。
如需发送 Body，请切换到 POST / PUT / PATCH / DELETE 方法。
Q: 中文参数或 Body 发送后出现乱码？
- 检查以下设置：
- 确认 Headers 中的
Content-Type包含正确的字符编码声明：Content-Type: application/json; charset=utf-8 - 后端服务是否支持 UTF-8 编码
NexHttp 默认使用 UTF-8 编码发送请求体，一般不存在乱码问题。
Q: 请求超时怎么办？
- 可能原因和解决：
- 目标服务器不可达 → 检查 URL 是否正确、网络是否连通
- 防火墙阻止 → 检查本机或网络防火墙规则
- 服务端处理太慢 → 属于正常等待，可检查后端日志
NexHttp 使用 Qt 默认的超时设置（通常约 30 秒）。
Q: 如何保存常用的 API 请求？
- 使用 固定 功能：
- 发送一次请求
- 在左侧历史列表中右键该记录
- 选择 重命名，输入有意义的名称
- 再次右键 → 固定
固定的记录不会被清空，下次启动时保留在历史列表中。
Q: 请求历史存在哪里？
请求历史保存在程序运行时内存中，关闭程序后不持久化。如需长期保存请求模板，建议使用固定功能配合导出（未来版本可能支持历史导入/导出）。
Q: 可以导入 Postman 的 Collection 吗？
当前版本暂不支持 Postman Collection 导入。该功能可能在后续版本中添加。
Q: 支持 HTTP/2 或 HTTP/3 吗？
当前版本基于 Qt Network 模块，支持 HTTP/1.1 和 HTTPS (TLS 1.2/1.3)。HTTP/2 和 HTTP/3 的支持取决于 Qt 版本和底层 OpenSSL 配置。
Q: 如何查看请求的原始报文？
点击 复制 cURL 按钮可以查看等效的 cURL 命令。如果需要在 Wireshark 等抓包工具中查看原始报文，可以配合网络抓包工具分析。