c++ Cpprestsdk怎么用 c++ HTTP客户端/服务端开发【教程】

cpprestsdk是微软开源的跨平台C++ HTTP库，支持异步客户端与服务端开发；需通过vcpkg安装并链接cpprest，Windows用WinHTTP、Linux/macOS依赖libcurl；客户端用http_client发请求，服务端用http_listener监听路由。

cpprestsdk（也叫Casablanca）是微软开源的C++ HTTP库，支持跨平台异步HTTP客户端和服务端开发。它基于现代C++11+特性，封装了底层网络细节，适合需要高性能、可移植HTTP能力的C++项目。

安装与环境准备

官方推荐通过vcpkg安装，最简单可靠：

• Windows：运行 vcpkg install cpprestsdk:x64-windows，再在CMake中启用vcpkg_toolchain_file
• Linux/macOS：用vcpkg或源码编译（需CMake 3.12+、Boost、OpenSSL、Zlib等依赖）
• CMake中链接时需添加：target_link_libraries(your_target PRIVATE cpprest)

注意：Windows下默认使用WinHTTP；Linux/macOS依赖libcurl，确保系统已安装libcurl4-openssl-dev（Ubuntu）或对应包。

HTTP客户端：发送GET/POST请求

核心类是http_client，配合http_request和http_response完成异步交互：

立即学习“C++免费学习笔记（深入）”；

爱改写

AI写作和改写润色工具

87

查看详情

• 发起GET请求：client.request(methods::GET, L"/api/data").then([](http_response res) { return res.extract_string(); }).wait();
• 带JSON的POST请求：构造json::value，调用req.set_body(json_val); req.set_method(methods::POST);
• 设置Header：用req.headers().add(L"Content-Type", L"application/json");
• 错误处理必须检查res.status_code()，不能只靠异常——网络超时、重定向、服务端5xx都可能返回成功task但状态码异常

HTTP服务端：快速启动REST接口

用http_listener监听路径，注册处理函数：

• 初始化监听器：http_listener listener(U("http://localhost:34567/api")); listener.support(methods::GET, handle_get);
• GET处理示例：提取查询参数用uri::split_query(req.request_uri().query())，返回JSON用res.set_body(json::value::object().set(U("msg"), U("ok")))
• POST解析JSON体：req.extract_json().then([](json::value j) { /* 处理j */ })
• 启动监听：listener.open().wait();，关闭用listener.close().wait();

注意：服务端不内置路由匹配，复杂路径需手动解析request_uri().path()，建议搭配轻量级路由封装（如自定义map映射路径到handler）。

常见问题与避坑提示

实际开发中容易卡住的点：

• 中文路径或参数必须URL编码，用uri::encode_uri()，否则http_listener可能解析失败
• 异步链中不要裸写.wait()在UI线程（如Win32消息循环），会阻塞；优先用.then()延续，或改用create_task包装
• JSON中文字符串要确保UTF-8编码，json::value::string(U"你好")自动转为UTF-8字节流，无需额外处理
• 服务端无法绑定0.0.0.0？检查防火墙或是否被占用；本地测试建议先用127.0.0.1

不复杂但容易忽略细节，把基础请求/响应流程跑通后，再逐步加认证、日志、连接池等扩展功能更稳妥。

以上就是c++ Cpprestsdk怎么用 c++ HTTP客户端/服务端开发【教程】的详细内容，更多请关注php中文网其它相关文章！