第39章 综合项目实战

打开你的IDE，创建一个名为 `SimpleHttpServer` 的新项目。这不是一个玩具，而是一个能同时处理数十个客户端连接、支持静态文件服务、并具备基本日志功能的迷你服务器。我们将用大约500行代码，把之前学过的知识串联起来。

项目架构设计：从需求到模块

一个软件项目就像建造房子，架构设计是蓝图。我们先明确核心需求：监听端口、接受连接、解析HTTP请求、返回文件或错误响应、记录日志。基于此，我们将系统划分为四个松耦合的模块。

网络模块负责底层的Socket通信；请求处理模块是大脑，解析HTTP并决定做什么；文件模块负责读取磁盘上的HTML、图片等静态资源；日志模块则贯穿始终，记录运行状态。我在一个嵌入式Web服务项目中踩过坑，最初把所有代码堆在main函数里，后期添加新功能时几乎要推倒重来。清晰的模块划分是项目可维护性的生命线。

核心模块实现剖析

我们从最基础的日志模块开始。一个有用的日志需要包含时间、级别、消息，并能输出到控制台和文件。

// Logger.h
class Logger {
public:
    enum class Level { DEBUG, INFO, WARN, ERROR };
    
    static Logger& getInstance(); // 单例模式
    void setLogFile(const std::string& filename);
    void log(Level level, const std::string& message, const std::string& file = "", int line = 0);

private:
    Logger() = default;
    std::ofstream logFile_;
    std::mutex logMutex_; // 多线程写日志需要互斥锁
};

注意第13行的`std::mutex`，这是多线程编程的关键。如果多个线程同时写入同一个文件流而不加锁，输出内容会混杂在一起，甚至导致程序崩溃。实现`log`函数时，第一件事就是`std::lock_guard lock(logMutex_);`。

接下来是网络模块。我们将封装一个`TcpServer`类，在其构造函数中完成Socket的创建、绑定和监听。

// 关键代码片段：启动服务器
TcpServer(uint16_t port, const std::string& rootDir) : rootDir_(rootDir) {
    serverFd_ = socket(AF_INET, SOCK_STREAM, 0);
    if (serverFd_ < 0) {
        throw std::runtime_error("Socket creation failed");
    }
    // 设置SO_REUSEADDR，避免“Address already in use”错误
    int opt = 1;
    setsockopt(serverFd_, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));
    // ... bind and listen
}

第8行的`setsockopt`调用是一个宝贵的实战经验。如果不设置`SO_REUSEADDR`，服务器崩溃后快速重启会绑定失败，需要等待几十秒（TIME_WAIT状态结束）。这在开发调试阶段极其影响效率。

HTTP请求处理与性能考量

请求处理模块是整个项目的核心。它需要从Socket读取数据，解析HTTP请求行（如`GET /index.html HTTP/1.1`），根据URL从文件模块获取内容，并组装HTTP响应。

这里有一个性能关键点：文件读取。如果每次请求都使用`std::ifstream`从头读取，对于频繁访问的小文件（如网站图标favicon.ico）会造成不必要的磁盘IO。一个简单的优化是引入一个基于LRU（最近最少使用）策略的内存缓存。

在组装响应时，务必正确设置`Content-Length`头部。如果长度不对，浏览器可能一直处于加载状态或显示不完整内容。使用`std::filesystem::file_size`（C++17）可以准确获取文件大小。

项目构建与调试

我们使用CMake来管理构建过程。`CMakeLists.txt`文件不仅指定编译源文件，还定义了编译选项、依赖查找等。

# CMakeLists.txt 核心部分
cmake_minimum_required(VERSION 3.10)
project(SimpleHttpServer VERSION 1.0)
set(CMAKE_CXX_STANDARD 17) # 使用C++17标准
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -O2 -pthread")

add_executable(${PROJECT_NAME}
    src/main.cpp
    src/Logger.cpp
    src/TcpServer.cpp
    src/HttpHandler.cpp
    src/FileCache.cpp
)

编译选项`-O2`启用编译器优化，`-pthread`链接线程库。在Linux上，如果你忘记`-pthread`，编译可能通过，但运行时调用`std::thread`会抛出`std::system_error`。这是典型的编译与运行时环境不一致的坑。

调试这样多线程的网络服务器，`gdb`是你的好朋友。但直接调试可能会因为多个线程同时运行而眼花缭乱。一个技巧是：在`main`函数开头加入`std::this_thread::sleep_for(std::chrono::seconds(10));`，让你有足够时间启动另一个终端，用`gdb -p `附加到进程上，然后再继续运行。

最后，让我们看看主函数如何将一切串联起来：

int main(int argc, char* argv[]) {
    try {
        uint16_t port = (argc > 1) ? std::stoi(argv[1]) : 8080;
        std::string rootDir = (argc > 2) ? argv[2] : "./www";
        
        Logger::getInstance().setLogFile("server.log");
        LOG_INFO("Starting server on port %d, root dir: %s", port, rootDir.c_str());
        
        TcpServer server(port, rootDir);
        server.run(); // 进入主循环，接受连接
    } catch (const std::exception& e) {
        LOG_ERROR("Fatal error: %s", e.what());
        return 1;
    }
    return 0;
}

第3-4行展示了从命令行参数读取配置，提高了灵活性。整个逻辑包裹在`try-catch`块中，确保任何未预期的异常都能被捕获并记录，而不是让程序无声无息地崩溃。