当前位置：首页 > news >正文

C++：发送HTTP请求（附带源码）

news 2026/5/12 11:13:10

项目背景详细介绍

在现代软件系统中，HTTP 已经成为事实上的应用层通信标准协议。

无论是：

Web 服务
微服务架构
云平台接口
RESTful API
第三方平台对接（支付、地图、AI）
软件更新 / 配置下发

其底层通信方式，几乎全部基于HTTP / HTTPS。

对于 C++ 开发者而言，“发送 HTTP 请求”是一个绕不开但又极易被低估的能力：

标准库不提供 HTTP 客户端
手写 HTTP 协议成本极高
涉及 Header、Body、编码、超时、HTTPS 等大量细节

因此，在真实工程中，C++ 程序几乎不可能自己实现完整 HTTP 协议栈，而是统一选择成熟库方案，其中：

libcurl 是 C / C++ 领域最主流、最可靠的 HTTP 客户端库

libcurl 被广泛应用于：

Git
Docker
Chrome
各类 Linux 系统组件
大量商业软件

因此，本项目的目标是：

使用 C++ + libcurl，完整演示如何发送 HTTP GET / POST 请求，并正确获取响应结果

该示例可直接作为：

C++ 工程项目基础模块
后台服务 HTTP 客户端
第三方接口对接模板
教学与博客文章
面试工程能力展示

项目需求详细介绍

1. 功能需求

支持 HTTP GET 请求
支持 HTTP POST 请求
支持携带请求参数
支持获取服务器响应内容
支持基础错误处理

2. 技术要求

使用 C++
基于 libcurl 库
使用回调函数接收响应数据
支持 HTTP / HTTPS

3. 教学与工程要求

封装 HTTP 请求逻辑为独立类
GET / POST 接口清晰分离
响应数据统一管理
代码结构可直接复用到真实项目

实现思路详细介绍

本项目采用工程级 HTTP 客户端封装方式：

初始化 libcurl 全局环境
定义 HttpClient 类
提供get()与post()接口
使用回调函数接收响应数据
将响应内容保存到字符串
返回调用结果给上层

该结构具有以下优势：

接口简单
易于维护
可无缝扩展 Header / Token / JSON
可直接用于生产项目

完整实现代码

/**************************************************** * File: HttpClient.h ****************************************************/ #pragma once #include <string> class HttpClient { public: HttpClient(); ~HttpClient(); bool get(const std::string& url, std::string& response); bool post(const std::string& url, const std::string& postData, std::string& response); private: static size_t writeCallback(void* ptr, size_t size, size_t nmemb, void* userdata); }; /**************************************************** * File: HttpClient.cpp ****************************************************/ #include "HttpClient.h" #include <curl/curl.h> HttpClient::HttpClient() { curl_global_init(CURL_GLOBAL_ALL); } HttpClient::~HttpClient() { curl_global_cleanup(); } size_t HttpClient::writeCallback(void* ptr, size_t size, size_t nmemb, void* userdata) { std::string* resp = static_cast<std::string*>(userdata); resp->append(static_cast<char*>(ptr), size * nmemb); return size * nmemb; } bool HttpClient::get(const std::string& url, std::string& response) { CURL* curl = curl_easy_init(); if (!curl) return false; curl_easy_setopt(curl, CURLOPT_URL, url.c_str()); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeCallback); curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response); curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); CURLcode res = curl_easy_perform(curl); curl_easy_cleanup(curl); return res == CURLE_OK; } bool HttpClient::post(const std::string& url, const std::string& postData, std::string& response) { CURL* curl = curl_easy_init(); if (!curl) return false; curl_easy_setopt(curl, CURLOPT_URL, url.c_str()); curl_easy_setopt(curl, CURLOPT_POST, 1L); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str()); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeCallback); curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response); curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); CURLcode res = curl_easy_perform(curl); curl_easy_cleanup(curl); return res == CURLE_OK; } /**************************************************** * File: main.cpp ****************************************************/ #include "HttpClient.h" #include <iostream> int main() { HttpClient client; std::string response; // GET 请求示例 if (client.get("https://httpbin.org/get", response)) std::cout << "GET Response:\n" << response << std::endl; else std::cout << "GET request failed\n"; response.clear(); // POST 请求示例 if (client.post("https://httpbin.org/post", "name=test&age=18", response)) std::cout << "POST Response:\n" << response << std::endl; else std::cout << "POST request failed\n"; return 0; }