【AI大模型接入SDK】ChatServer接口测试

🎬 个人主页：艾莉丝努力练剑

❄专栏传送门：《C语言》《数据结构与算法》《C/C++干货分享&学习过程记录》 《Linux操作系统编程详解》《笔试/面试常见算法：从基础到进阶》《Python干货分享》

⭐️为天地立心，为生民立命，为往圣继绝学，为万世开太平

🎬 艾莉丝的简介：

文章目录

• 1 ~> ChatServer 接口整体测试体系
• • 1.1 测试前置准备
  • • 1.1.1 接口清单录入（Apifox）
    • 1.1.2 Apifox 环境配置
    • 1.1.3 会话 ID 生成规则
• 2 ~> 逐个接口测试流程与业务逻辑
• • 2.1 GET /api/models 获取可用模型
  • • 2.1.1 请求规约
    • 2.1.2 返回 JSON 结构
    • 2.1.3 测试校验点
  • 2.2 POST /api/session 创建会话
  • • 2.2.1 请求规约
    • 2.2.2 返回 JSON 结构
    • 2.2.3 业务逻辑
  • 2.3 GET /api/sessions 获取会话列表
  • • 2.3.1 请求规约
    • 2.3.2 返回 JSON 结构
    • 2.3.3 业务校验
  • 2.4 DELETE /api/session/{session_id} 删除会话
  • • 2.4.1 请求规约
    • 2.4.2 返回 JSON
    • 2.4.3 业务校验
  • 2.5 GET /api/session/{session_id}/history 获取会话历史消息
  • • 2.5.1 请求规约
    • 2.5.2 典型故障点（代码 BUG 复盘）
    • 2.5.3 校验标准
  • 2.6 POST /api/message 发送消息‑全量返回
  • • 2.6.1 请求规约
    • 2.6.2 业务逻辑
    • 2.6.3 校验
  • 2.7 POST /api/message/async 发送消息‑SSE 流式增量返回
  • • 2.7.1 请求规约
    • 2.7.2 SSE 流式协议关键知识点
    • 2.7.3 代码故障复盘
    • 2.7.4 测试校验点
• 3 ~> 多模型兼容性测试
• • 3.1 测试策略
  • 3.2 外部模型环境依赖
  • 3.3 测试流程示例（gpt‑4o‑mini）
• 4 ~> SQLite 数据库存储层关键要点
• • 4.1 数据表
  • 4.2 开发调试手段
• 5 ~> 整体排错方法论
• 结尾

1 ~> ChatServer 接口整体测试体系

1.1 测试前置准备

1.1.1 接口清单录入（Apifox）

• 共 7 个后端接口，服务基于 http‑lib 实现路由注册

  表格

  请求方法接口路径接口功能

  POST	/api/session	创建会话
  GET	/api/sessions	获取会话列表
  GET	/api/models	获取可用模型列表
  DELETE	/api/session/{session_id}	删除指定会话
  GET	/api/session/{session_id}/history	获取会话历史消息
  POST	/api/message	发送消息‑全量返回
  POST	/api/message/async	发送消息‑流式增量返回

// ChatServer 路由注册核心代码片段
void ChatServer::setupHttpRoutes(){
// 创建会话
_chatServer->Post(pattern="/api/session", handler=[this](const httplib::Request& request, httplib::Response& response){
handleCreateSessionRequest(request, response);
});
// 获取会话列表
_chatServer->Get(pattern="/api/sessions", handler=[this](const httplib::Request& request, httplib::Response& response){
handleGetSessionListsRequest(request, response);
});
// 获取可用模型
_chatServer->Get(pattern="/api/models", handler=[this](const httplib::Request& request, httplib::Response& response){
handleGetModelListsRequest(request, response);
});
// 删除会话
_chatServer->Delete(pattern="/api/session/(.*)", handler=[this](const httplib::Request& request, httplib::Response& response){
handleDeleteSessionRequest(request, response);
});
// 获取会话历史消息
_chatServer->Get(pattern="/api/session/(.*)/history", handler=[this](const httplib::Request& request, httplib::Response& response){
handleGetHistoryMessagesRequest(request, response);
});
// 发送消息-全量返回
_chatServer->Post(pattern="/api/message", handler=[this](const httplib::Request& request, httplib::Response& response){
handleSendMessageRequest(request, response);
});
// 发送消息-流式增量返回
_chatServer->Post(pattern="/api/message/async", handler=[this](const httplib::Request& request, httplib::Response& response){
handleSendMessageStreamRequest(request, response);
});
}

1.1.2 Apifox 环境配置

1.1.3 会话 ID 生成规则

• 会话 ID 格式：session_时间戳_序号
• 序号由服务内部静态计数器维护；服务器进程不重启，计数器持续累加，不会重置
• SessionManager 初始化会从数据库读取已有会话，恢复计数器基数

// 会话ID生成关键片段
std::string SessionManager::generateSessionId(){
// _sessionCounter 静态成员变量，进程生命周期持续自增
_sessionCounter.fetch_add(1);
std::time_t t = std::time(nullptr);
return "session_" + std::to_string(t) + "_" + std::to_string(_sessionCounter);
}

2 ~> 逐个接口测试流程与业务逻辑

2.1 GET /api/models 获取可用模型

2.1.1 请求规约

• HTTP 方法：GET，无请求参数

2.1.2 返回 JSON 结构

{
"success": true,
"message": "get model lists success",
"data": [
{
"name": "deepseek-chat",
"desc": "一款基于Deepseek的实用性强、功能强大的、中文优化的通用聊天模型，用于生成自然语言回复，适合用于聊天、问答、对话等场景"
}
]
}

2.1.3 测试校验点

• HTTP 200；success 字段为 true；data 数组返回全部配置好的模型元数据。

2.2 POST /api/session 创建会话

2.2.1 请求规约

• HTTP 方法：POST
• Content‑Type: application/json
• 请求 Body

{
"model":"deepseek-chat"
}

2.2.2 返回 JSON 结构

{
"success": true,
"message": "create session success",
"data": {
"model": "deepseek‑chat",
"session_id": "session_1789031979_00000001"
}
}

2.2.3 业务逻辑

• 指定模型创建全新会话，生成唯一 session_id；会话初始化消息计数为 0；写入 SQLite 数据库sessions表。

2.3 GET /api/sessions 获取会话列表

2.3.1 请求规约

• HTTP 方法：GET，无请求参数

2.3.2 返回 JSON 结构

{
"success": true,
"message": "get session lists success",
"data": [
{
"id": "session_1789049548_00000002",
"model": "deepseek‑r1:1.5b",
"created_at": 1789049548,
"updated_at": 1789049548,
"message_count": 0
}
]
}

2.3.3 业务校验

• 返回全部持久化会话集合；message_count 统计该会话下问答消息总条数。

2.4 DELETE /api/session/{session_id} 删除会话

2.4.1 请求规约

• HTTP 方法：DELETE
• Path 参数：session_id 会话唯一标识

2.4.2 返回 JSON

{
"success": true,
"message": "delete session success"
}

2.4.3 业务校验

• 删除会话数据库记录；再次调用获取会话列表接口，该会话不再出现在 data 数组。

2.5 GET /api/session/{session_id}/history 获取会话历史消息

2.5.1 请求规约

• HTTP 方法：GET
• Path 参数：session_id

2.5.2 典型故障点（代码 BUG 复盘）

// 错误代码片段
int rc = sqlite3_step(stmt);
if(rc != SQLITE_DONE){
// 错误：单条记录读取完毕 rc=SQLITE_DONE，误判为执行失败
}

// 修正后逻辑
int rc = sqlite3_step(stmt);
if(rc != SQLITE_ROW){
// 只有读到行才算有效数据，SQLITE_DONE代表查询结束
}

2.5.3 校验标准

• 根据 session_id 读取 messages 表，返回该会话完整历史问答消息集合。

2.6 POST /api/message 发送消息‑全量返回

2.6.1 请求规约

• POST，Content‑Type:application/json

{
"session_id":"session_xxxx",
"message":"请讲一个笑话"
}

2.6.2 业务逻辑

2.6.3 校验

• 返回完整应答文本；获取历史消息接口可以看到新增两条消息（用户提问 + 模型回复）。

2.7 POST /api/message/async 发送消息‑SSE 流式增量返回

2.7.1 请求规约

• POST，Content‑Type:application/json，请求体与全量接口完全一致。

2.7.2 SSE 流式协议关键知识点

• Response 的 Content‑Type 必须设置为 text/event‑stream，禁止使用 application/json；application/json 会让客户端把整体当做 JSON 报文解析，不会逐块流式渲染。

• SSE 报文格式：

  data: 分片内容\\n\\n
  data: 分片内容\\n\\n
  data: [DONE]\\n\\n

• data: [DONE]为流结束标记；HTTP 长连接保持，分块传输 chunked 编码。

2.7.3 代码故障复盘

// 错误代码，第二个参数last=true直接标记流结束，连接立刻关闭
writeChunk("", true);

// 修复代码 last=false，代表不是流的最后一块
writeChunk("", false);

writeChunk 第二个布尔参数 last 语义：true 表示当前 chunk 是流的最后一个分片，发送data:[DONE]结束 SSE 会话；false 代表后续还有数据分片。

// 错误
response->set_chunked_content_provider("application/json", providerLambda);
// 修正
response->set_chunked_content_provider("text/event‑stream", providerLambda);
// 流式请求处理修正后完整核心逻辑
void ChatServer::handleSendMessageStreamRequest(const httplib::Request& request, httplib::Response& response)
{
std::string sessionId = request.json["session_id"].asString();
std::string message = request.json["message"].asString();
if(sessionId.empty() || message.empty()){
response->status = 400;
return;
}
response->status = 200;
response->set_header("Cache‑Control", "no‑cache");
response->set_header("Connection", "keep‑alive");
// SSE必须使用 text/event‑stream
response->set_chunked_content_provider("text/event‑stream",
[this, sessionId, message](size_t offset, httplib::DataSink& dataSink)->bool{
auto writeChunk = [&](const std::string& chunk, bool last)->void{
// 转SSE报文格式
std::string sseData = "data: " + json::valueToQuotedString(chunk.c_str()) + "\\n\\n";
dataSink.write(sseData.c_str(), sseData.size());
if(last){
std::string doneData = "data: [DONE]\\n\\n";
dataSink.write(doneData.c_str(), doneData.size());
dataSink.done();
}
};
// 发送空块，防止客户端超时等待；last=false，流不关闭
writeChunk("", false);
// 调用SDK流式回调
_chatSDK->sendMessageStream(sessionId, message, writeChunk);
return true;
});
}

2.7.4 测试校验点

3 ~> 多模型兼容性测试

3.1 测试策略

• 基础会话、会话列表、删除会话、获取模型接口仅需针对一个模型完成验证。
• 其余模型只需要重点验证全量返回、SSE 流式增量返回两个消息发送接口。

3.2 外部模型环境依赖

• 云端模型（GPT 系列等）服务器访问受限场景，启动服务进程前需要配置代理环境变量。
• Ollama 本地模型无需外网代理，服务本地访问 ollama 服务端口。

3.3 测试流程示例（gpt‑4o‑mini）

4 ~> SQLite 数据库存储层关键要点

4.1 数据表

4.2 开发调试手段

• 使用 sqlite3 命令行工具直接打开 db 文件，select 查询表数据，确认业务数据是否真正持久化，区分「内存对象正常」与「数据库持久化异常」两类 BUG。

5 ~> 整体排错方法论

重点：静态库更新之后，上层服务必须重新编译链接，否则运行程序依旧加载旧版本 SDK 二进制。

结尾

uu们，本文的内容到这里就全部结束了，艾莉丝在这里再次感谢您的阅读！

结语：希望对学习Linux相关内容的uu有所帮助，不要忘记给博主“一键四连”哦！

往期回顾：

【AI大模型接入SDK】ChatServer问题修复

🗡博主在这里放了一只小狗，大家看完了摸摸小狗放松一下吧！🗡

૮₍ ˶ ˊ ᴥ ˋ˶₎ა