在libwebsockets中使用spdlog进行日志输出的最佳实践

背景介绍

libwebsockets是一个轻量级的C语言库，用于实现WebSocket协议。在实际开发中，我们经常需要将libwebsockets的日志输出与其他应用程序日志统一管理，而spdlog是一个高性能的C++日志库，非常适合这种场景。

问题分析

当尝试将libwebsockets的日志重定向到spdlog时，会遇到两个主要问题：

1. libwebsockets默认会在每条日志前添加时间戳前缀
2. 日志行末尾会自动添加换行符

这会导致使用spdlog输出时出现重复的时间戳和额外的空行，影响日志的可读性和一致性。

解决方案

禁用libwebsockets默认时间戳

通过编译选项可以禁用libwebsockets的默认时间戳功能。在CMake配置中添加以下选项：

set(LWS_LOGS_TIMESTAMP 0)

或者在编译命令中直接指定：

cmake -DLWS_LOGS_TIMESTAMP=0 ...

自定义日志回调函数

libwebsockets允许开发者自定义日志处理函数。我们可以创建一个适配器函数，将libwebsockets的日志转发到spdlog：

static void lws_to_spdlog_adapter(int level, const char* line) {
    // 移除可能的换行符
    std::string log_line(line);
    if (!log_line.empty() && log_line.back() == '\n') {
        log_line.pop_back();
    }

    // 根据日志级别转发到spdlog
    switch (level) {
        case LLL_ERR:    spdlog::error(log_line); break;
        case LLL_WARN:   spdlog::warn(log_line); break;
        case LLL_NOTICE:
        case LLL_INFO:   spdlog::info(log_line); break;
        case LLL_DEBUG:  spdlog::debug(log_line); break;
        default:        spdlog::trace(log_line); break;
    }
}

完整初始化示例

int main() {
    // 初始化spdlog
    auto logger = spdlog::basic_logger_mt("lws_logger", "logs/lws.log");
    spdlog::set_default_logger(logger);
    spdlog::set_level(spdlog::level::debug);
    logger->set_pattern("[%t][%Y-%m-%d %H:%M:%S.%e] [%L] [%s] - %v");

    // 配置libwebsockets日志
    lws_set_log_level(LLL_ALL, lws_to_spdlog_adapter);

    // 其他初始化代码...
    return 0;
}

进阶建议

1. 日志级别映射：可以根据项目需求调整libwebsockets日志级别到spdlog级别的映射关系
2. 性能考虑：在高性能场景下，可以考虑使用spdlog的异步日志模式
3. 日志过滤：在回调函数中可以添加额外的过滤逻辑，只记录特定类型的日志
4. 多线程安全：确保spdlog的日志器配置为多线程安全模式

通过以上方法，可以实现libwebsockets日志与应用程序其他部分日志的统一管理，提高系统的可维护性和日志分析效率。