Poco C++ HTTP 库超详细使用教程（服务端+客户端 开源实战示例）

一、Poco 库简介与优势1.1 什么是 PocoPoco Libraries 是一套开源、跨平台、标准 C 编写的基础工具库对标 Java 基础库、Boost 简化替代方案封装了网络、文件、线程、日志、JSON、加密、HTTP 等高频能力工业级稳定广泛用于工控、嵌入式、后台服务、桌面工具开发。1.2 Poco HTTP 模块核心优势纯 C 跨平台一套代码全平台编译无平台兼容成本零多余依赖无需 Boost、无需 libcurl自带完整 HTTP 栈客户端服务端双支持同时实现 HTTP 调用和 HTTP 服务支持 HTTPS/SSL内置 OpenSSL 适配开箱即用加密请求支持文件上传、表单提交、长连接、超时控制MIT 开源协议完全免费可商用二、Poco 环境搭建与编译2.1 环境依赖编译器GCC7 / Clang / MSVC2017编译工具CMake / Make可选依赖OpenSSL如需 HTTPS 功能2.2 下载 Poco 源码推荐拉取官方稳定版本# 下载源码 git clone https://github.com/pocoproject/poco.git cd poco mkdir build cd build2.3 CMake 编译命令Linux/Mac# 编译完整模块含HTTP、SSL、JSON、Net cmake .. -DCMAKE_BUILD_TYPERelease make -j8 sudo make install2.4 极简 CMake 项目配置新建业务项目CMakeLists.txt适配所有 HTTP 示例cmake_minimum_required(VERSION 3.13) project(PocoHttpDemo) set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 查找Poco库 find_package(Poco REQUIRED Net Util JSON NetSSL) # 引入头文件与库 include_directories(${Poco_INCLUDE_DIRS}) link_directories(${Poco_LIBRARY_DIRS}) # 可执行文件 add_executable(http_demo main.cpp) target_link_libraries(http_demo Poco::Net Poco::Util Poco::JSON Poco::NetSSL )三、核心实战示例一HTTP 客户端 GET 请求实现最常用的HTTP GET 请求、参数拼接、响应读取、超时控制可直接调用第三方接口#include iostream #include string // Poco HTTP核心头文件 #include Poco/Net/HTTPClientSession.h #include Poco/Net/HTTPRequest.h #include Poco/Net/HTTPResponse.h #include Poco/StreamCopier.h #include Poco/URI.h using namespace Poco; using namespace Poco::Net; // HTTP GET 请求示例 void HttpGetDemo() { try { // 1. 定义请求地址 std::string url http://httpbin.org/get?namePocoage20; URI uri(url); // 2. 创建HTTP会话 HTTPClientSession session(uri.getHost(), uri.getPort()); session.setTimeout(Poco::Timespan(5, 0)); // 5秒超时 // 3. 构造GET请求 HTTPRequest request(HTTPRequest::HTTP_GET, uri.getPathAndQuery(), HTTPRequest::HTTP_11); request.set(User-Agent, Poco-C-HttpClient); // 4. 发送请求、获取响应 HTTPResponse response; std::ostream out session.sendRequest(request); std::istream in session.receiveResponse(response); // 5. 读取响应内容 std::string resBody; StreamCopier::copyToString(in, resBody); // 输出结果 std::cout 响应状态码 response.getStatus() std::endl; std::cout 响应内容\n resBody std::endl; session.close(); } catch (Poco::Exception e) { std::cerr GET请求异常 e.what() std::endl; } } int main() { HttpGetDemo(); return 0; }四、核心实战示例二HTTP 客户端 POST JSON 请求日常开发高频场景POST 提交 JSON 数据适配后端接口交互。#include iostream #include string #include Poco/Net/HTTPClientSession.h #include Poco/Net/HTTPRequest.h #include Poco/Net/HTTPResponse.h #include Poco/StreamCopier.h #include Poco/URI.h #include Poco/JSON/Parser.h using namespace Poco; using namespace Poco::Net; using namespace Poco::JSON; void HttpPostJsonDemo() { try { std::string url http://httpbin.org/post; URI uri(url); HTTPClientSession session(uri.getHost(), uri.getPort()); session.setTimeout(Poco::Timespan(5, 0)); // 1. 构造POST JSON请求 HTTPRequest request(HTTPRequest::HTTP_POST, uri.getPath(), HTTPRequest::HTTP_11); request.setContentType(application/json;charsetutf-8); request.set(User-Agent, Poco-Post-Client); // 2. 构造JSON报文 Parser parser; Dynamic::Var obj parser.parse({}); JSONObject::Ptr json obj.extractJSONObject::Ptr(); json-set(username, CSDN-Poco); json-set(password, 123456); json-set(code, 200); std::string postBody json-toString(); request.setContentLength(postBody.length()); // 3. 发送请求体 std::ostream out session.sendRequest(request); out postBody; // 4. 接收响应 HTTPResponse response; std::istream in session.receiveResponse(response); std::string resBody; StreamCopier::copyToString(in, resBody); std::cout POST响应\n resBody std::endl; session.close(); } catch (Poco::Exception e) { std::cerr POST请求异常 e.what() std::endl; } } int main() { HttpPostJsonDemo(); return 0; }五、进阶示例三HTTP 表单文件上传Poco 自带HTMLForm轻松实现表单参数文件上传无需手动拼接二进制流。#include iostream #include Poco/Net/HTTPClientSession.h #include Poco/Net/HTTPRequest.h #include Poco/Net/HTTPResponse.h #include Poco/Net/HTMLForm.h #include Poco/StreamCopier.h #include Poco/URI.h using namespace Poco; using namespace Poco::Net; void HttpUploadFileDemo() { try { std::string url http://httpbin.org/post; URI uri(url); HTTPClientSession session(uri.getHost(), uri.getPort()); session.setTimeout(Poco::Timespan(10, 0)); HTTPRequest request(HTTPRequest::HTTP_POST, uri.getPath(), HTTPRequest::HTTP_11); // 构造表单 HTMLForm form; form.set(desc, Poco文件上传测试); // 上传本地文件自行替换文件路径 form.addFile(file, test.txt, hello poco http lib); // 设置表单Content-Type form.prepareSend(request); // 发送表单数据 std::ostream out session.sendRequest(request); form.write(out); // 接收响应 HTTPResponse response; std::istream in session.receiveResponse(response); std::string resBody; StreamCopier::copyToString(in, resBody); std::cout 文件上传响应\n resBody std::endl; session.close(); } catch (Poco::Exception e) { std::cerr 文件上传异常 e.what() std::endl; } } int main() { HttpUploadFileDemo(); return 0; }六、核心实战示例四Poco HTTP 服务端极简接口服务很多人只知道 Poco 做客户端不知道 Poco 可以快速搭建轻量 HTTP 服务端适合内嵌式接口服务。#include iostream #include Poco/Net/HTTPServer.h #include Poco/Net/HTTPRequestHandler.h #include Poco/Net/HTTPRequestHandlerFactory.h #include Poco/Net/HTTPServerParams.h #include Poco/Net/HTTPServerRequest.h #include Poco/Net/HTTPServerResponse.h #include Poco/Net/ServerSocket.h #include Poco/JSON/JSONObject.h using namespace Poco; using namespace Poco::Net; using namespace Poco::JSON; // 自定义请求处理器 class MyRequestHandler : public HTTPRequestHandler { public: void handleRequest(HTTPServerRequest req, HTTPServerResponse resp) override { resp.setChunkedTransferEncoding(true); resp.setContentType(application/json;charsetutf-8); std::ostream out resp.send(); // 简单路由 if (req.getURI() /hello) { JSONObject json; json.set(code, 200); json.set(msg, success); json.set(data, Hello Poco HTTP Server!); out json.toString(); } else if (req.getURI() /api/info) { JSONObject json; json.set(code, 200); json.set(name, Poco-C-HTTP); json.set(author, CSDN); out json.toString(); } else { out R({code:404,msg:接口不存在}); } out.flush(); } }; // 处理器工厂 class MyHandlerFactory : public HTTPRequestHandlerFactory { public: HTTPRequestHandler* createRequestHandler(const HTTPServerRequest) override { return new MyRequestHandler(); } }; int main() { try { // 监听8080端口 ServerSocket socket(8080); HTTPServerParams* params new HTTPServerParams(); params-setKeepAlive(false); HTTPServer server(new MyHandlerFactory(), socket, params); server.start(); std::cout Poco HTTP服务启动成功监听端口8080 std::endl; // 阻塞等待 getchar(); server.stop(); } catch (Poco::Exception e) { std::cerr 服务启动异常 e.what() std::endl; } return 0; }服务端测试启动程序后访问http://127.0.0.1:8080/hellohttp://127.0.0.1:8080/api/info正常返回标准 JSON 数据极简 HTTP 接口服务搭建完成七、进阶示例五HTTPS 加密请求Poco 支持 HTTPS 开箱即用只需替换 SSL 会话类代码改动极小#include iostream #include Poco/Net/SecureStreamSocket.h #include Poco/Net/SecureStreamSocketImpl.h #include Poco/Net/HTTPSClientSession.h #include Poco/Net/HTTPRequest.h #include Poco/Net/HTTPResponse.h #include Poco/StreamCopier.h #include Poco/URI.h using namespace Poco; using namespace Poco::Net; void HttpsGetDemo() { try { std::string url https://httpbin.org/get; URI uri(url); // 使用HTTPS客户端会话 HTTPSClientSession session(uri.getHost(), uri.getPort()); session.setTimeout(Poco::Timespan(5, 0)); HTTPRequest request(HTTPRequest::HTTP_GET, uri.getPathAndQuery(), HTTPRequest::HTTP_11); HTTPResponse response; std::ostream out session.sendRequest(request); std::istream in session.receiveResponse(response); std::string res; StreamCopier::copyToString(in, res); std::cout HTTPS响应\n res std::endl; session.close(); } catch (Poco::Exception e) { std::cerr HTTPS请求异常 e.what() std::endl; } } int main() { HttpsGetDemo(); return 0; }八、常见报错与解决方案8.1 编译报错undefined reference原因未链接 Net/JSON/NetSSL 模块解决CMake 中必须链接Poco::Net Poco::JSON Poco::NetSSL8.2 网络请求超时解决手动设置session.setTimeout(Timespan(5,0))延长超时时间8.3 HTTPS 证书校验失败解决测试环境可关闭证书校验生产环境配置合法证书链九、总结Poco 是C 轻量网络开发的神器相比 libcurl、Boost.Beast它的优势是API 简单、功能聚合、跨平台零适配、同时支持客户端服务端。本文覆盖了工业级最常用的 5 大场景HTTP GET 常规请求HTTP POST JSON 交互表单文件上传自建 HTTP 接口服务端HTTPS 加密网络请求所有代码均可直接复制编译运行可直接用于项目开发、工具开发、嵌入式 HTTP 服务场景。