极简C语言HTTP服务器的HTTP Headers处理技术问询

问题背景 #

我正在开发一个极简C语言HTTP服务器，该服务器可完成监听、绑定、接受连接及处理基础HTTP请求的操作。我了解HTTP Headers在客户端与服务器间传递附加信息的重要性，但不确定如何正确处理并响应它们。

现有代码片段 #

#define BUFFER_SIZE 4096 // 补充缺失的缓冲区宏定义

void HandleHeaders(int ClientSocket, char *request){
  
  char response[BUFFER_SIZE];
}

void HandleResponse(int ClientSocket, char *request){
  char *response = "HTTP/1.1 200 OK\r\nContent-Type: text/plain\r\n\r\nHOLA\n";
  write(ClientSocket, response, strlen(response));
}

void HandleRequest(int ServerSocket, int ClientSocket){
    // 获取socket接收的数据并存储到缓冲区
    char request [BUFFER_SIZE]; // 缓冲区
    
    int DatosDelBuffer = recv(ClientSocket, request, sizeof(request), 0);

    // 检查缓冲区内容
    if(DatosDelBuffer < 0 ){
      perror("Error leer el buffer!\n");
      exit(EXIT_FAILURE);
    } else if(strncmp(request,"GET / ",6) == 0){
      printf("%s\n",request); 
      HandleResponse(ClientSocket,request);
    } else if(strncmp(request, "GET /headers",12) == 0){
      HandleHeaders(ClientSocket, request);
    } else {
      char *response = "HTTP/1.1 404 Not Found\r\nContent-Type: text/plain\r\n\r\n404 Not Found";
      write(ClientSocket, response, strlen(response)); 
    }    
    
    // 关闭socket，终止连接
    close(ClientSocket);
}

我曾在网上查找相关示例或解释，但多数结果仅定义了HTTP Headers，未展示如何在C语言中处理它们。

具体问题 #

1. 如何正确解析并提取请求中的HTTP Headers？
2. 应如何构造包含自定义Headers的响应？
3. 简单C语言服务器处理HTTP Headers有哪些最佳实践？

解决方案 #

1. 解析并提取请求中的HTTP Headers #

HTTP请求结构为：请求行 + 若干请求头 + 空行 + 请求体（可选），请求头之间用\r\n分隔，最后一个请求头后以\r\n\r\n标记头部结束。解析步骤如下：

• 用strtok按\r\n分割请求字符串，跳过第一行（请求行）
• 对每个请求头按:分割为键和值，去除值前后的空格

示例实现：

#include <string.h>
#include <stdio.h>

// 解析请求头，可按需将键值对存储到结构体
void ParseHeaders(char *request) {
    char *line = strtok(request, "\r\n");
    line = strtok(NULL, "\r\n"); // 跳过请求行
    
    while (line != NULL && strlen(line) > 0) {
        char *colon = strchr(line, ':');
        if (colon != NULL) {
            *colon = '\0';
            char *key = line;
            char *value = colon + 1;
            // 去除值前的空格
            while (*value == ' ') value++;
            printf("Header: %s -> %s\n", key, value);
        }
        line = strtok(NULL, "\r\n");
    }
}

// 修改HandleHeaders函数，解析并返回请求头信息
void HandleHeaders(int ClientSocket, char *request){
    char response[BUFFER_SIZE];
    // 复制请求字符串，避免strtok修改原数据
    char request_copy[BUFFER_SIZE];
    strncpy(request_copy, request, BUFFER_SIZE - 1);
    request_copy[BUFFER_SIZE - 1] = '\0';
    
    // 初始化响应
    int len = snprintf(response, BUFFER_SIZE, "HTTP/1.1 200 OK\r\nContent-Type: text/plain\r\n\r\n");
    
    // 解析并拼接请求头到响应
    char *line = strtok(request_copy, "\r\n");
    line = strtok(NULL, "\r\n");
    
    while (line != NULL && strlen(line) > 0) {
        char *colon = strchr(line, ':');
        if (colon != NULL) {
            *colon = '\0';
            char *key = line;
            char *value = colon + 1;
            while (*value == ' ') value++;
            len += snprintf(response + len, BUFFER_SIZE - len, "%s: %s\r\n", key, value);
        }
        line = strtok(NULL, "\r\n");
    }
    
    write(ClientSocket, response, strlen(response));
}

2. 构造包含自定义Headers的响应 #

HTTP响应结构为：状态行 + 若干响应头 + 空行 + 响应体，构造时需注意：

• 每个响应头以键: 值\r\n格式书写
• 所有响应头写完后必须加\r\n标记头部结束，再拼接响应体

示例实现：

void HandleCustomResponse(int ClientSocket) {
    char response[BUFFER_SIZE];
    // 构造状态行+自定义响应头+响应体
    snprintf(response, BUFFER_SIZE, 
             "HTTP/1.1 200 OK\r\n"
             "Content-Type: text/html\r\n"
             "Server: MyMinimalCServer/1.0\r\n" // 自定义Server标识头
             "X-Custom-Header: HelloFromC\r\n" // 自定义私有业务头
             "\r\n" // 头部结束标记
             "<html><body><h1>Custom Header Response</h1></body></html>");
    
    write(ClientSocket, response, strlen(response));
}

如果需要动态拼接响应头，可使用snprintf逐步拼接，注意不要超出缓冲区大小。

3. 简单C语言服务器处理HTTP Headers的最佳实践 #

• 缓冲区安全：始终使用strncpy、snprintf等带长度限制的函数，避免缓冲区溢出，建议设置BUFFER_SIZE为4096或8192。
• 处理不完整请求：recv可能仅收到部分请求数据，需循环读取直到接收到\r\n\r\n标记，避免解析不完整的头部。
• 忽略大小写：HTTP头的键大小写不敏感（如Content-Type与content-type等价），解析时可统一转为小写或大写后处理。
• 必填响应头不可缺：响应至少要包含Content-Type（告知客户端响应体格式），若有响应体建议添加Content-Length（方便客户端判断数据完整性）。
• 资源清理：解析时若使用临时缓冲区或动态分配内存，需及时释放，避免内存泄漏。
• 容错处理：遇到格式不合法的请求头（如无冒号），直接忽略该头部，不要因单个错误头导致整个请求处理失败。

内容的提问来源于stack exchange，提问作者Solrojo