个人主页艾莉丝努力练剑❄专栏传送门《C语言》《数据结构与算法》《C/C干货分享学习过程记录》《Linux操作系统编程详解》《笔试/面试常见算法从基础到进阶》《Python干货分享》⭐️为天地立心为生民立命为往圣继绝学为万世开太平 艾莉丝的简介文章目录1 ~ ChatServer main.cpp 工程实现1.1 整体需求规约1.1.1 业务需求清单1.1.2 文件约束1.2 ServerConfig 结构体定义1.3 gflags 参数定义 main.cpp 头部1.4 工具函数实现1.4.1 环境变量读取工具1.4.2 信号处理回调函数1.4.3 参数校验函数 validateConfig1.4.4 帮助打印函数 showAPIInfo1.5 main 主函数完整实现1.6 ChatServer::start 内部线程实现 (ChatServer.cpp)2 ~ ChatServer.conf 配置文件模板3 ~ 环境变量配置云端 API 密钥4 ~ 关键易错点总结面试高频4.1 gflags flagfile 加载顺序4.2 线程模型关键点4.3 信号处理注意事项4.4 密钥安全规范4.5 头文件路径坑4.6 参数校验边界5 ~ CMakeLists.txt 关键片段6 ~ 程序运行命令示例结尾1 ~ ChatServer main.cpp 工程实现背景基于 C gflags spdlog 二次封装日志库实现 AI 聊天服务入口 main 程序核心职责参数解析、配置校验、日志初始化、信号处理、服务启动、主线程保活。1.1 整体需求规约1.1.1 业务需求清单使用 gflags 库定义全部ServerConfig配置项参数来源优先级gflags 默认值 ChatServer.conf 配置文件 命令行参数网络服务默认绑定地址0.0.0.0端口8080默认日志级别INFO云端大模型deepseek /chatgpt/geminiAPI 密钥从操作系统环境变量读取禁止通过命令行传入Ollama 全套配置通过 gflags 命令行 / 配置文件提供模型默认参数temperature0.7max_tokens2048配置文件ChatServer.conf放置在 ChatServer 项目目录由 gflags 原生 flagfile 机制加载禁止手写自定义配置解析逻辑禁止代码生成配置文件命令行功能-h / --help打印帮助文档、使用示例、全部 HTTP API 接口说明-v / --version打印程序版本号默认版本1.0.0参数合法性校验规则temperature 取值范围必须0.0 ~ 2.0max_tokens 必须大于 0不能为负数云端 API Key 至少存在一个不为空若填写 Ollama 任意一项则 Ollama 全部三项配置模型名称、描述、endpoint必须全部非空服务器业务线程ChatServer 内部将 HTTP 服务运行在独立 detach 分离线程main 主线程负责保活、信号响应不能阻塞在服务监听逻辑。日志模块项目 sdk 封装 spdlog 日志bite::Logger头文件安装到系统 include直接引入ai_chat_sdk/util/myLog.h禁止使用相对路径引用头文件。1.1.2 文件约束main.cpp 存放路径ChatServer 目录下需求文档ChatServer/required/main需求.txt1.2 ServerConfig 结构体定义文件位置 ChatServer/ChatServer.h#pragmaonce#includestring#includehttplib.hnamespaceai_chat_server{structServerConfig{// 网络服务配置std::string host0.0.0.0;intport8080;std::string logLevelINFO;// LLM模型公共参数doubletemperature0.7;intmaxTokens2048;// 云端模型密钥从环境变量读取std::string deepseekAPIKey;std::string chatGPTAPIKey;std::string geminiAPIKey;// Ollama本地大模型配置由gflags参数传入std::string ollamaModelName;std::string ollamaModelDesc;std::string ollamaEndpoint;};classChatServer{public:explicitChatServer(constServerConfigconfig);boolstart();voidstop();boolisRunning()const;private:// http路由、业务处理成员省略};}1.3 gflags 参数定义 main.cpp 头部#includeChatServer.h#includeai_chat_sdk/util/myLog.h#includegflags/gflags.h#includefstream#includethread#includecsignal#includecstdlib// 网络服务参数DEFINE_string(host,0.0.0.0,服务器绑定监听地址);DEFINE_int32(port,8080,HTTP服务监听端口);DEFINE_string(log_level,INFO,日志级别: TRACE|DEBUG|INFO|WARN|ERROR|CRITICAL);DEFINE_string(config_file,./ChatServer.conf,gflags配置文件路径(flagfile格式));// LLM模型公共参数DEFINE_double(temperature,0.7,模型温度取值范围0.0~2.0);DEFINE_int32(max_tokens,2048,模型最大输出token数量);// Ollama相关参数命令行/配置文件传入DEFINE_string(ollama_model_name,,Ollama模型名称);DEFINE_string(ollama_model_desc,,Ollama模型描述信息);DEFINE_string(ollama_endpoint,,Ollama服务API地址例如http://127.0.0.1:11434);constexprconstchar*VERSION1.0.0;// 全局服务器智能指针用于信号回调访问服务实例namespaceai_chat_server{std::unique_ptrChatServerg_server;std::atomicboolg_running{true};}1.4 工具函数实现1.4.1 环境变量读取工具// 读取系统环境变量不存在返回空字符串staticstd::stringgetEnvVar(conststd::stringkey){constchar*valstd::getenv(key.c_str());returnval?std::string(val):;}1.4.2 信号处理回调函数捕获SIGINT(CtrlC)、SIGTERM信号优雅停止服务安全退出进程staticvoidsignalHandler(intsig){usingnamespaceai_chat_server;(void)sig;g_running.store(false);if(g_server){g_server-stop();}}1.4.3 参数校验函数 validateConfigstaticboolvalidateConfig(constai_chat_server::ServerConfigconfig){// 校验temperature范围if(config.temperature0.0||config.temperature2.0){ERR(配置校验失败: temperature必须处于0.0~2.0当前值{},config.temperature);returnfalse;}// maxTokens必须大于0if(config.maxTokens0){ERR(配置校验失败: max_tokens必须大于0当前值{},config.maxTokens);returnfalse;}// 云端密钥至少有一个API Key不为空boolhasCloudKey!config.deepseekAPIKey.empty()||!config.chatGPTAPIKey.empty()||!config.geminiAPIKey.empty();// Ollama只要任意一个字段非空则全部三个字段必须全部配置boolhasAnyOllama!config.ollamaModelName.empty()||!config.ollamaModelDesc.empty()||!config.ollamaEndpoint.empty();boolollamaComplete!config.ollamaModelName.empty()!config.ollamaModelDesc.empty()!config.ollamaEndpoint.empty();if(hasAnyOllama!ollamaComplete){ERR(配置校验失败Ollama配置项不能部分填写model_name、model_desc、endpoint必须同时提供);returnfalse;}// 必须至少拥有云端key或者完整Ollama配置if(!hasCloudKey!ollamaComplete){ERR(配置校验失败至少配置一个云端API Key或者一套完整Ollama模型配置);returnfalse;}returntrue;}1.4.4 帮助打印函数 showAPIInfo-h / --help触发打印参数说明、启动示例、全部 REST API 接口清单staticvoidshowAPIInfo(){std::cout\n AIChatServer 使用帮助 \n;std::cout版本: VERSION\n\n;std::cout启动示例:\n;std::cout ./AIChatServer 使用默认参数启动\n;std::cout ./AIChatServer --port9000 指定端口启动\n;std::cout ./AIChatServer --config_file./ChatServer.conf 加载配置文件\n;std::cout\n环境变量设置示例(云端密钥):\n;std::cout export DEEPSEEK_API_KEYxxx\n;std::cout\n可用HTTP API接口:\n;std::cout POST /api/session 创建会话\n;std::cout GET /api/sessions 获取全部会话列表\n;std::cout GET /api/models 获取可用模型列表\n;std::cout DELETE/api/session/{id} 删除指定会话\n;std::cout GET /api/session/{id}/history 获取会话历史\n;std::cout POST /api/message 发送消息全量返回\n;std::cout POST /api/message/async 发送消息流式返回\n;std::cout\n;}1.5 main 主函数完整实现执行流程设置 gflags 提示文本、版本字符串原生 gflags 解析命令行判断配置文件是否存在使用gflags::SetCommandLineOption(flagfile,xxx)加载配置文件打印帮助文档判断注册信号捕获组装 ServerConfig 结构体云端 key 读环境变量Ollama 参数读取 gflags参数合法性校验初始化 spdlog 日志器设置日志级别实例化 ChatServer调用 start ()内部 HTTP 服务运行在 detach 分离子线程主线程循环保活等待停止信号服务退出程序返回intmain(intargc,char**argv){usingnamespaceai_chat_server;try{// gflags初始化gflags::SetUsageMessage(AI聊天服务AI ChatServer);gflags::SetVersionString(VERSION);// 解析命令行参数remove_flagstrue将解析过的flag从argv移除gflags::ParseCommandLineFlags(argc,argv,true);// 使用gflags原生flagfile加载配置文件禁止手写配置解析逻辑std::ifstreamconfFile(FLAGS_config_file);if(confFile.is_open()){gflags::SetCommandLineOption(flagfile,FLAGS_config_file.c_str());confFile.close();INFO(成功加载配置文件:{},FLAGS_config_file);// 注意flagfile会重新触发参数解析优先级命令行 flagfile 默认值}else{WARN(配置文件{}不存在将仅使用命令行与默认参数,FLAGS_config_file);}// -h / --help 打印帮助信息if(argc1){std::stringopt(argv[1]);if(opt-h||opt--help){showAPIInfo();return0;}}// 注册信号处理器捕获CtrlC、进程终止信号signal(SIGINT,signalHandler);signal(SIGTERM,signalHandler);// 组装ServerConfig配置ServerConfig config;config.hostFLAGS_host;config.portFLAGS_port;config.logLevelFLAGS_log_level;config.temperatureFLAGS_temperature;config.maxTokensFLAGS_max_tokens;// 云端大模型密钥从系统环境变量读取不在命令行暴露密钥config.deepseekAPIKeygetEnvVar(DEEPSEEK_API_KEY);config.chatGPTAPIKeygetEnvVar(CHATGPT_API_KEY);config.geminiAPIKeygetEnvVar(GEMINI_API_KEY);// Ollama参数全部取自gflags命令行/配置文件config.ollamaModelNameFLAGS_ollama_model_name;config.ollamaModelDescFLAGS_ollama_model_desc;config.ollamaEndpointFLAGS_ollama_endpoint;// 参数安全校验if(!validateConfig(config)){ERR(服务配置校验失败程序退出);returnEXIT_FAILURE;}// 初始化spdlog封装日志器bite::Loggerspdlog::level::level_enum logLevelspdlog::level::info;if(config.logLevelTRACE)logLevelspdlog::level::trace;elseif(config.logLevelDEBUG)logLevelspdlog::level::debug;elseif(config.logLevelINFO)logLevelspdlog::level::info;elseif(config.logLevelWARN)logLevelspdlog::level::warn;elseif(config.logLevelERROR)logLevelspdlog::level::err;elseif(config.logLevelCRITICAL)logLevelspdlog::level::critical;// 初始化日志实例输出至控制台日志文件chat_server.logbite::Logger::initLogger(ChatServer,chat_server.log,logLevel);// 打印启动配置信息INFO( AIChatServer启动配置 );INFO(版本号:{},VERSION);INFO(监听地址:{}:{},config.host,config.port);INFO(日志级别:{},config.logLevel);INFO(temperature:{},config.temperature);INFO(max_tokens:{},config.maxTokens);INFO(DeepSeek Key:{},config.deepseekAPIKey.empty()?未设置:已设置);INFO(ChatGPT Key:{},config.chatGPTAPIKey.empty()?未设置:已设置);INFO(Gemini Key:{},config.geminiAPIKey.empty()?未设置:已设置);INFO(Ollama模型:{},config.ollamaModelName.empty()?未启用:config.ollamaModelName);// 创建服务实例ChatServer::start内部启动独立detach线程运行http服务g_serverstd::make_uniqueChatServer(config);boolstartOkg_server-start();if(!startOk){ERR(ChatServer服务启动失败);returnEXIT_FAILURE;}INFO(ChatServer启动成功地址 http://{}:{},config.host,config.port);INFO(按下 CtrlC 停止服务);// 主线程保活循环// http服务运行在子线程主线程不能立刻return否则进程直接退出// g_running原子布尔收到SIGINT/SIGTERM会被置false退出循环while(g_running.load()g_server-isRunning()){std::this_thread::sleep_for(std::chrono::seconds(1));}INFO(收到停止信号服务正常退出);g_server.reset();returnEXIT_SUCCESS;}catch(conststd::exceptione){ERR(程序发生异常: {},e.what());returnEXIT_FAILURE;}catch(...){ERR(程序发生未知异常);returnEXIT_FAILURE;}}1.6 ChatServer::start 内部线程实现 (ChatServer.cpp)HTTP 服务运行在 detach 分离线程不阻塞 main 主线程boolChatServer::start(){// ...省略路由初始化代码std::threadserverThread([this](){_chatServer-listen(_config.host,_config.port);});// detach分离线程线程独立运行不需要主线程joinserverThread.detach();_isRunning.store(true);returntrue;}2 ~ ChatServer.conf 配置文件模板放置于 ChatServer 目录gflags flagfile 格式每行写--flag_namevalue#代表注释程序代码不生成该文件由使用者手动编写维护# ChatServer.conf gflags flagfile配置文件 # 网络服务配置 --host0.0.0.0 --port8080 --log_levelINFO # LLM公共参数 --temperature0.7 --max_tokens2048 # Ollama本地模型配置使用ollama才需要打开注释 #--ollama_endpointhttp://127.0.0.1:11434 #--ollama_model_namedeepseek‑r1:1.5b #--ollama_model_desc本地部署开源推理模型3 ~ 环境变量配置云端 API 密钥API 密钥属于敏感信息不在配置文件 / 命令行明文存储设置 Linux shell 环境变量# ~/.bashrc 添加exportDEEPSEEK_API_KEYsk‑xxxxexportCHATGPT_API_KEYsk‑xxxxexportGEMINI_API_KEYxxxx# 生效配置source~/.bashrc# 验证环境变量是否生效echo$DEEPSEEK_API_KEY4 ~ 关键易错点总结面试高频4.1 gflags flagfile 加载顺序gflags 内置默认值flagfile 配置文件参数命令行传入参数优先级最高覆盖配置文件错误做法手写文件解析字符串切割模拟 flagfile正确调用gflags::SetCommandLineOption(flagfile, path)交给库原生解析。4.2 线程模型关键点ChatServer HTTP 监听运行在detach()分离子线程main 主线程必须保留循环保活如果 main 直接 return整个进程会销毁子线程同步终止服务立刻停止使用std::atomicbool原子变量做运行标记在信号处理器修改原子标记保证多线程内存可见性。4.3 信号处理注意事项信号回调函数上下文限制不能执行复杂 IO、不能调用 spdlog 打印日志只修改原子标记、调用 stop、重置智能指针。捕获SIGINT(CtrlC)SIGTERM(kill 命令终止进程)实现优雅关闭。4.4 密钥安全规范云端 API 密钥禁止 gflags 命令行参数传入命令行参数可以被 ps 命令全局查看造成密钥泄露密钥从操作系统环境变量读取。4.5 头文件路径坑日志库头文件已经安装进系统 include 目录#include ai_chat_sdk/util/myLog.h禁止使用#include ../sdk/include/util/myLog.h相对路径跨编译环境会编译失败。4.6 参数校验边界temperature 闭区间[0.0, 2.0]max_tokens 严格大于 0Ollama 配置部分字段填写属于非法状态要么全部为空要么三项全部非空整体至少有一套可用模型云端 key OR 完整 Ollama 配置。5 ~ CMakeLists.txt 关键片段project(AIChatServer) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 依赖库 gflags spdlog find_package(gflags REQUIRED) find_package(spdlog REQUIRED) add_executable(AIChatServer ChatServer/main.cpp ChatServer/ChatServer.cpp ) target_link_libraries(AIChatServer gflags::gflags spdlog::spdlog ai_chat_sdk )6 ~ 程序运行命令示例# 1. 默认参数启动读取ChatServer.conf./AIChatServer# 2. 指定端口命令行参数优先级高于配置文件./AIChatServer--port9000#3. 指定自定义配置文件路径./AIChatServer--config_file./my.conf#4. 查看帮助文档./AIChatServer-h#5. 查看版本./AIChatServer-v结尾uu们本文的内容到这里就全部结束了艾莉丝在这里再次感谢您的阅读艾莉丝努力练剑C/C Linux 底层探索者 | 一个正在努力练剑的技术博主【关注】跟随我一起深耕技术领域见证每一次成长。❤️【点赞】让优质内容被更多人看见让知识传递更有力量。⭐【收藏】把核心知识点存好在需要时随时查、随时用。【评论】分享你的经验或疑问评论区一起交流避坑不要忘记给博主“一键四连”哦“今日练剑达成”“技术之路难免有困惑但同行的人会让前进更有方向。”结语希望对学习Linux相关内容的uu有所帮助不要忘记给博主“一键四连”哦往期回顾【AI大模型接入SDK】Trae生成代码介绍博主在这里放了一只小狗大家看完了摸摸小狗放松一下吧૮₍ ˶ ˊ ᴥ ˋ˶₎ა
