基于C Socket的HTTP Web服务器无法加载HTML页面问题排查

浏览器无限加载通常是因为服务器未发送符合HTTP规范的完整响应，或连接逻辑存在阻塞，以下是针对性排查和修复方向：

1. 严格校验HTTP响应格式 #

HTTP协议对响应格式有强制要求，任何不符合的地方都会导致浏览器无法解析并持续等待：

• 响应首行必须遵循 HTTP/1.x 状态码 状态描述\r\n 格式，例如 HTTP/1.1 200 OK\r\n
• 响应头部与正文之间必须有空行（即\r\n\r\n），这是区分头部和内容的关键，很多开发者会漏掉这一步
• 必须通过Content-Length头部明确告知浏览器正文长度，或使用Transfer-Encoding: chunked编码；缺少长度标识时，浏览器无法判断接收是否完成，会一直等待连接关闭
• 所有头部行的换行必须用\r\n，不能仅用\n

正确的响应示例：

const char* valid_response = 
    "HTTP/1.1 200 OK\r\n"
    "Content-Type: text/html; charset=utf-8\r\n"
    "Content-Length: 22\r\n"
    "Connection: close\r\n"
    "\r\n"
    "<h1>Hello Web Server</h1>";

2. 确保响应数据完整发送 #

send()函数可能因网络缓冲区未满，仅发送部分数据，需循环发送直到全部字节完成：

ssize_t total_sent = 0;
size_t resp_len = strlen(valid_response);
ssize_t sent_bytes;

while (total_sent < resp_len) {
    sent_bytes = send(client_fd, valid_response + total_sent, resp_len - total_sent, 0);
    if (sent_bytes == -1) {
        perror("send failed");
        break;
    }
    total_sent += sent_bytes;
}

3. 处理连接关闭逻辑 #

• 如果未在响应头部设置Connection: close，需在发送完响应后调用close(client_fd)主动关闭客户端连接；否则浏览器会保持长连接，等待后续请求，表现为无限加载
• 避免在发送响应前，卡在读取请求的循环中（比如错误地一直等待客户端发送更多请求数据）

4. 调试辅助手段 #

• 使用curl -v http://[服务器IP]:[端口]手动发送请求，查看服务器返回的原始响应，直接定位格式问题
• 在代码中添加日志，记录生成的响应内容、send()的返回值，确认响应是否正确生成并发送

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