20、C++项目实战：简易Web服务器

说实话，很多学C++的朋友都问过我一个问题：“我学了这么久C++，到底能做什么实际的东西？”

嗯，今天这个项目就是最好的答案——用C++写一个简易Web服务器。别被“服务器”三个字吓到，说白了，它就是一个能听懂HTTP协议、能返回网页的小程序。我当年第一次写完这个项目时，那种“浏览器里真的显示出我写的Hello World”的成就感，至今难忘。

核心知识点：Socket编程、HTTP协议解析、多线程处理、静态文件服务

一、Web服务器到底在做什么？

先想一个问题：你在浏览器输入 http://localhost:8080/index.html，回车，发生了什么？

简单来说就三步：

  1. 浏览器向你的程序发起一个TCP连接（说白了就是打电话）
  2. 浏览器发送一段文本（HTTP请求），比如“GET /index.html HTTP/1.1”
  3. 你的程序解析这段文本，找到对应的文件，把内容打包成HTTP响应发回去

我刚开始做的时候，总觉得这中间有什么黑魔法。后来自己动手写了一遍才发现，核心逻辑其实就几十行代码。来看一张整体流程图：

浏览器 HTTP请求 简易Web服务器 Socket监听 + 请求解析 多线程处理 读取文件 文件系统 返回文件内容 HTTP响应 多线程处理模型 主线程（监听） 工作线程1 工作线程2 工作线程N 每个连接分配一个线程，互不阻塞

二、核心代码实现

2.1 创建Socket监听

一切从Socket开始。我习惯用POSIX的socket API，跨平台性更好。注意一点：绑定端口后一定要调用listen()，不然客户端连不上。

#include <sys/socket.h>
#include <netinet/in.h>
#include <unistd.h>

int createServerSocket(int port) {
    int server_fd = socket(AF_INET, SOCK_STREAM, 0);
    if (server_fd < 0) {
        perror("socket创建失败");
        return -1;
    }

    // 设置SO_REUSEADDR，避免"Address already in use"
    int opt = 1;
    setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));

    struct sockaddr_in address;
    address.sin_family = AF_INET;
    address.sin_addr.s_addr = INADDR_ANY;  // 监听所有网卡
    address.sin_port = htons(port);

    if (bind(server_fd, (struct sockaddr*)&address, sizeof(address)) < 0) {
        perror("bind失败");
        close(server_fd);
        return -1;
    }

    if (listen(server_fd, 10) < 0) {  // 10是最大等待队列长度
        perror("listen失败");
        close(server_fd);
        return -1;
    }

    return server_fd;
}

⚠️ 我曾经踩过的坑：忘记设置SO_REUSEADDR。服务器崩溃后重启，端口还被占用着，bind直接失败。当时排查了半天，最后发现是TIME_WAIT状态在作怪。加上这个选项后，问题解决。

2.2 解析HTTP请求

HTTP请求的格式其实很简单。第一行是请求行，后面跟着一堆Header，最后空一行结束。我们只需要解析第一行就够了——知道客户端要什么文件。

#include <sstream>
#include <string>
#include <vector>

struct HttpRequest {
    std::string method;    // GET, POST等
    std::string path;      // /index.html
    std::string version;   // HTTP/1.1
};

HttpRequest parseRequest(const std::string& raw) {
    HttpRequest req;
    std::istringstream stream(raw);
    std::string line;
    
    // 只读第一行
    if (std::getline(stream, line)) {
        // 去掉末尾的\r
        if (!line.empty() && line.back() == '\r') {
            line.pop_back();
        }
        
        std::istringstream lineStream(line);
        lineStream >> req.method >> req.path >> req.version;
    }
    
    return req;
}

💡 小技巧：解析时注意处理\r\n和\n两种换行符。Windows和Linux的HTTP请求可能不同，我习惯统一去掉末尾的\r。

2.3 构建HTTP响应

响应格式同样简单：状态行 + Header + 空行 + 正文。我一般这样组织：

std::string buildResponse(int statusCode, const std::string& statusText,
                          const std::string& contentType,
                          const std::string& body) {
    std::ostringstream response;
    response << "HTTP/1.1 " << statusCode << " " << statusText << "\r\n";
    response << "Content-Type: " << contentType << "\r\n";
    response << "Content-Length: " << body.size() << "\r\n";
    response << "Connection: close\r\n";
    response << "\r\n";  // 空行分隔Header和Body
    response << body;
    return response.str();
}

// 使用示例
std::string html = "<h1>Hello, World!</h1>";
std::string resp = buildResponse(200, "OK", "text/html", html);

2.4 多线程处理连接

单线程服务器一次只能处理一个请求，后面的客户端得排队等着。这显然不行。我采用每连接一线程的模式：

#include <thread>
#include <vector>

void handleClient(int client_fd) {
    // 1. 读取请求
    char buffer[4096] = {0};
    read(client_fd, buffer, sizeof(buffer));
    
    // 2. 解析请求
    HttpRequest req = parseRequest(buffer);
    
    // 3. 处理请求（这里简化，直接返回Hello）
    std::string body = "<h1>Hello from C++ Server!</h1>";
    std::string response = buildResponse(200, "OK", "text/html", body);
    
    // 4. 发送响应
    send(client_fd, response.c_str(), response.size(), 0);
    
    // 5. 关闭连接
    close(client_fd);
}

int main() {
    int server_fd = createServerSocket(8080);
    if (server_fd < 0) return 1;
    
    std::cout << "服务器启动，监听端口 8080..." << std::endl;
    
    while (true) {
        struct sockaddr_in client_addr;
        socklen_t addr_len = sizeof(client_addr);
        
        int client_fd = accept(server_fd, 
                               (struct sockaddr*)&client_addr, 
                               &addr_len);
        if (client_fd < 0) {
            perror("accept失败");
            continue;
        }
        
        // 创建线程处理客户端
        std::thread t(handleClient, client_fd);
        t.detach();  // 分离线程，让它在后台运行
    }
    
    close(server_fd);
    return 0;
}

⚠️ 注意：生产环境中每连接一线程的开销很大。如果并发量高，建议改用线程池。我这个例子只是为了演示原理，实际项目中我一般用固定大小的线程池。

三、完整项目结构

一个像样的Web服务器，至少需要这几个文件：

文件 作用
server.h / server.cpp Socket创建、监听、accept循环
http_parser.h / http_parser.cpp HTTP请求解析、响应构建
file_handler.h / file_handler.cpp 读取静态文件、处理404
thread_pool.h / thread_pool.cpp 线程池管理（可选，但推荐）
main.cpp 入口，组装各个模块

四、避坑指南

做这个项目时，我遇到过几个让人抓狂的问题，分享出来帮你省点时间：

  • 端口被占用：每次重启服务器前，记得用netstat -tulnp | grep 8080检查端口状态。或者像我一样，代码里加上SO_REUSEADDR。
  • 中文乱码：返回HTML时，Content-Type里加上charset=utf-8。不然浏览器可能用GBK解码，中文全变问号。
  • 大文件传输：不要一次性把整个文件读到内存里。用sendfile()系统调用，零拷贝效率高得多。
  • 连接超时：客户端可能只发了一半请求就断开了。设置setsockopt的SO_RCVTIMEO，避免线程卡死。

核心总结：简易Web服务器的本质，就是Socket监听 → 请求解析 → 文件读取 → 响应返回这四个步骤。多线程只是为了让服务器能同时服务多个客户端。你想想看，是不是比想象中简单？

我个人觉得，这个项目是C++学习者从“语法练习”走向“实际应用”的最佳跳板。它涉及网络编程、协议解析、并发处理，每一个都是真实项目中的硬技能。写完之后，你再去理解Nginx、Apache这些大家伙，会发现它们本质上也是在做同样的事——只不过做得更极致、更高效。

好了，代码都在上面了。打开你的编辑器，动手试试吧。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →