【AI开发之Rust】第 18 课:SQLite 持久化与本地缓存 —— 给 store 填上真实现

发布时间:2026/11/19 8:10:19

【AI开发之Rust】第 18 课:SQLite 持久化与本地缓存 —— 给 store 填上真实现 18.1 这节课解决什么问题第 17 课的HistoryStore还是内存假实现——App 一重启历史全丢。本课把它换成SQLite本地数据库回答三件事① rusqlite怎么连、怎么建表、怎么读写参数化查询防注入 ② 表结构 迁移schema 版本升级不丢数据 ③ 把 sqlite 实现塞回 core服务层测试一行不改17 课接口红利的兑现同时处理 SQLite 在真实 App 里最常见的最后 20%忙锁database is locked、连接共享、并发读写。这些坑恰恰是 UniFFI19-21 课把 core 暴露给多个 UI 线程后必然撞上的。 为什么本地存储选 SQLite 而不是写个 JSON 文件历史记录会持续增长需要随机查询单会话/删除/排序——JSON 全量读改写在大数据量下又慢又容易坏。SQLite 单文件、零服务、SQL 能力完整是移动/桌面端本地存储的事实标准。会话与消息的结构化适合表而聊天原样快照之类大对象适合存成 JSON 列/独立文件——两种都会在本课出现。18.2 rusqlite 起步打开连接 最小读写# core/Cargo.toml 追加 [dependencies] rusqlite { version 0.32, features [bundled] } # bundled免系统 SQLite跨端更省心 chrono 不再需要——时间用 i64 毫秒第 17 课 now_ms// store/sqlite.rs —— 新的模块userusqlite::Connection;usestd::path::Path;pubstructSqliteStore{conn:Connection,}implSqliteStore{/// 打开或创建数据库文件pubfnopen(path:implAsRefPath)-ResultSelf,rusqlite::Error{letconnConnection::open(path)?;conn.pragma_update(None,journal_mode,WAL)?;// 见 18.5conn.pragma_update(None,foreign_keys,ON)?;letstoreSqliteStore{conn};store.migrate()?;// 见 18.3Ok(store)}}最小读写样例临时库:memory:可用于测试userusqlite::{params,Connection};fnmain()-rusqlite::Result(){letconnConnection::open_in_memory()?;conn.execute(CREATE TABLE kv (k TEXT PRIMARY KEY, v TEXT NOT NULL),[])?;// 参数化插入占位符 ?1值作为参数传入 → 自动防注入conn.execute(INSERT INTO kv (k, v) VALUES (?1, ?2),params![greeting,你好])?;// 参数化查询letv:Stringconn.query_row(SELECT v FROM kv WHERE k ?1,[greeting],|row|row.get(0),)?;println!({v});// 多行读取迭代 Statementletmutstmtconn.prepare(SELECT k, v FROM kv)?;letrowsstmt.query_map([],|row|{Ok((row.get::_,String(0)?,row.get::_,String(1)?))})?;forpairinrows{println!({:?},pair?);}Ok(())}⚠️永远用参数化绝不要字符串拼接 SQL// ❌ 注入风险 引号转义地狱letsqlformat!(INSERT INTO kv VALUES ({}),user_input);// ✅ 参数绑定rusqlite 负责转义SQL 与数据分离conn.execute(INSERT INTO kv VALUES (?1),params![user_input])?;18.3 表结构与迁移schema 版本化18.3.1 建表 DDL-- sessions会话表CREATETABLEIFNOTEXISTSsessions(idTEXTPRIMARYKEY,-- s-ms-randtitleTEXTNOTNULL,created_at_msINTEGERNOTNULL);-- messages消息表CREATETABLEIFNOTEXISTSmessages(idTEXTPRIMARYKEY,session_idTEXTNOTNULLREFERENCESsessions(id)ONDELETECASCADE,roleTEXTNOTNULL,-- user / assistant / systemcontentTEXTNOTNULL,created_at_msINTEGERNOTNULL);CREATEINDEXIFNOTEXISTSidx_messages_sessionONmessages(session_id,created_at_ms);ON DELETE CASCADE删会话自动连带删消息17 课 delete_session 就两个动作其实库层一步到位索引建在(session_id, created_at_ms)上查单会话历史只走索引随数据增长不退化role用 TEXT 存读出来再转Role枚举写入反过来——不存 SQLite 不认识的 Rust enum。18.3.2 用PRAGMA user_version做轻量迁移implSqliteStore{/// 简单迁移记录 schema 版本号逐版升级fnmigrate(self)-rusqlite::Result(){letcur:i64self.conn.query_row(PRAGMA user_version,[],|r|r.get(0))?;ifcur1{self.conn.execute_batch(BEGIN; CREATE TABLE IF NOT EXISTS sessions (...同 18.3.1...); CREATE TABLE IF NOT EXISTS messages (...); CREATE INDEX ...; PRAGMA user_version 1; COMMIT;,)?;}// 将来加字段/加表if cur 2 { ... PRAGMA user_version 2; }Ok(())}} 真实项目可用rusqlite_migration这类 crate 管理有序迁移脚本但用户版本号 逐段 execute_batch的原生写法已经足够支撑本课程规模且零额外依赖。关键是养成习惯任何 schema 变更都必须是新增一段 if 版本号的迁移而不是改旧 SQL——否则老用户升级必炸。18.4 实现 HistoryStore for SqliteStoreusecrate::models::{Message,Role,Session};usecrate::store::{HistoryStore,StoreError};userusqlite::params;implHistoryStoreforSqliteStore{fncreate_session(self,session:Session)-Result(),StoreError{self.conn.execute(INSERT INTO sessions (id, title, created_at_ms) VALUES (?1, ?2, ?3),params![session.id,session.title,session.created_at_ms],).map_err(map_err)?;Ok(())}fnlist_sessions(self,limit:u32)-ResultVecSession,StoreError{letmutstmtself.conn.prepare(SELECT id, title, created_at_ms FROM sessions ORDER BY created_at_ms DESC LIMIT ?1).map_err(map_err)?;letrowsstmt.query_map([limit],|row|{Ok(Session{id:row.get(0)?,title:row.get(1)?,created_at_ms:row.get(2)?,})}).map_err(map_err)?;rows.collect::ResultVec_,_().map_err(map_err)}fndelete_session(self,session_id:str)-Result(),StoreError{self.conn.execute(DELETE FROM sessions WHERE id ?1,params![session_id]).map_err(map_err)?;// messages 靠 CASCADE 一起删Ok(())}fnappend_message(self,msg:Message)-Result(),StoreError{letrolerole_to_db(msg.role);// Role → strself.conn.execute(INSERT INTO messages (id, session_id, role, content, created_at_ms) VALUES (?1, ?2, ?3, ?4, ?5),params![msg.id,msg.session_id,role,msg.content,msg.created_at_ms],).map_err(map_err)?;Ok(())}fnlist_messages(self,session_id:str)-ResultVecMessage,StoreError{letmutstmtself.conn.prepare(SELECT id, session_id, role, content, created_at_ms FROM messages WHERE session_id ?1 ORDER BY created_at_ms ASC,).map_err(map_err)?;letrowsstmt.query_map([session_id],|row|{letrole:Stringrow.get(2)?;Ok(Message{id:row.get(0)?,session_id:row.get(1)?,role:role_from_db(role),content:row.get(3)?,created_at_ms:row.get(4)?,})}).map_err(map_err)?;rows.collect::ResultVec_,_().map_err(map_err)}fnclear_messages(self,session_id:str)-Result(),StoreError{self.conn.execute(DELETE FROM messages WHERE session_id ?1,params![session_id]).map_err(map_err)?;Ok(())}}/// 把 rusqlite 错误统一转成 StoreError第 17 课的契约类型fnmap_err(e:rusqlite::Error)-StoreError{matche{rusqlite::Error::QueryReturnedNoRowsStoreError::NotFound(记录不存在.into()),otherStoreError::Io(other.to_string()),}}fnrole_to_db(role:Role)-staticstr{matchrole{Role::Useruser,Role::Assistantassistant,Role::Systemsystem}}fnrole_from_db(s:str)-Role{matchs{assistantRole::Assistant,systemRole::System,_Role::User}} 读 DB 行 → Rust struct 的样板循环query_maprow.get在代码里很常见。量大后可考虑serde的 rusqlite 适配derive直接映射行但先学会手写版错误类型和列顺序都由你掌控。18.5 并发与database is locked真实 App 必修课18.5.1 问题从哪来第 19 课起UI 的多个线程/任务可能同时调append_message用户连发多条、list_sessions刷新列表、delete_session。SQLite 默认一次只允许一个写者写锁没释放时另一写会报database is locked。rusqlite 的Connection默认不是Sync含内部缓存直接放进Boxdyn HistoryStore并跨线程调用会编译不过。三种处理姿势姿势做法适用A. 每操作新开连接线程/调用各自Connection::open演示、低频B. 进程级单连接 外部 MutexMutexConnection串行化所有访问简单可靠本课采用C. 连接池r2d2_sqlite之类高并发、多读多写本课采用 B把Connection包在Mutex里天然满足Sync且把写冲突变成排队加上 18.2 已开的 WAL 模式读不阻塞写usestd::sync::Mutex;pubstructSqliteStore{conn:MutexConnection,// 内部串行化对外仍是 Sync}implSqliteStore{pubfnopen(path:implAsRefstd::path::Path)-ResultSelf,rusqlite::Error{letconnConnection::open(path)?;conn.pragma_update(None,journal_mode,WAL)?;conn.pragma_update(None,foreign_keys,ON)?;letstoreSqliteStore{conn:Mutex::new(conn)};store.migrate()?;Ok(store)}fnlock(self)-Resultstd::sync::MutexGuard_,Connection,StoreError{self.conn.lock().map_err(|_|StoreError::Io(存储锁中毒.into()))}}然后每个方法开头let conn self.lock()?;后续全部走connimplHistoryStoreforSqliteStore{fncreate_session(self,session:Session)-Result(),StoreError{letconnself.lock()?;conn.execute(INSERT INTO sessions (id, title, created_at_ms) VALUES (?1, ?2, ?3),params![session.id,session.title,session.created_at_ms],).map_err(map_err)?;Ok(())}// ……其余方法同样先 lock()}⚠️ 同步方法里用std::sync::Mutex没问题不跨.await持有。永远不要在持锁期间调用 UI/网络——锁粒度 一条 SQL。SQLite 单次操作毫秒级串行化完全可接受。18.5.2 WAL 模式是什么journal_mode WALWrite-Ahead Logging - 写操作先追加到 .wal 文件再择机合入主库 - 效果读写不互相阻塞一个写者 多个读者可同时进行 - App 常见标配配合 busy_timeout 可进一步缓解极端冲突// 极端冲突兜底等锁最长 5 秒而不是立刻报错conn.busy_timeout(std::time::Duration::from_secs(5))?;18.6 把真 store 接回 service17 课测试一行不改// core 集成测试sqlite_smoke.rsusemy_ai_core::llm::chat::ChatLlm;usemy_ai_core::models::Message;usemy_ai_core::service::AssistantService;usemy_ai_core::store::{HistoryStore,SqliteStore};structFakeLlm;// 同 17.6#[tokio::test]asyncfnsqlite_roundtrip_via_service(){// 临时文件库测完自动删letdirstd::env::temp_dir();letpathdir.join(format!(ai_test_{}.db,std::process::id()));letstoreSqliteStore::open(path).unwrap();letserviceAssistantService::new(Box::new(FakeLlm),Box::new(store),系统提示.into());letsessionservice.new_session(持久化测试).await.unwrap();letmutgotString::new();service.ask_stream(session.id,存下来了吗,Box::new(|d|got.push_str(d))).await.unwrap();assert!(got.contains(你好世界));// 重新打开同一个文件模拟 App 重启数据还在letstore2SqliteStore::open(path).unwrap();letsessionsstore2.list_sessions(10).unwrap();assert_eq!(sessions.len(),1);letmsgsstore2.list_messages(session.id).unwrap();assert_eq!(msgs.len(),2);std::fs::remove_file(path).ok();}验收瞬间同一段 service 测试把MemStore::default()换成SqliteStore::open(...)就跑通——17 课设计的接口抽象兑现了。18.7 动手练习参考实现放code/18-sqlite/写作时同步给出。rusqlite 最小读写:memory:建表/插入/查询/迭代练参数化与query_map收行。防注入验证向 18.2 的插入函数传x); DROP TABLE kv; --确认它只是被当作普通字符串存进去参数化生效。完整实现 HistoryStore for SqliteStore按 18.4 补全全部 6 个方法并跑通 18.6 的冒烟测试。迁移实验先建 version1 的库再用version2给 messages 加一列 complete INTEGER DEFAULT 1的迁移脚本升级验证老数据不丢、新字段可写。忙锁观察开两个SqliteStore指向同一文件线程 A 在事务里sleep 200ms后提交线程 B 同时写——先不设 busy_timeout 记录报错再设 5s 观察排队成功。并发冒烟8 个 tokio 任务各 append 50 条消息到同一会话结束后断言总数 400体会 Mutex 串行化 WAL 的效果。综合重点给messages补complete列并在模型加字段让ask_stream断流时FakeLlm 抛StreamInterrupted能落一条completefalse的尾巴消息——为 19 课流中断可恢复预演。验收门禁能写出带?1占位 params!的最小读写能说出 WAL 解决了什么、Mutex 解决了什么能解释为什么 schema 变更必须走版本迁移而不是改旧 SQL。✅ 本节小结rusqlitebundled特性免系统依赖:memory:便于测试永远参数化 SQLschemasessions/messages 两张表 复合索引 ON DELETE CASCADEPRAGMA user_version做增量迁移枚举映射DB 存 TEXT行读取时再转回 Rust enum并发MutexConnection串行化天然 Sync、WAL 读写分离、busy_timeout兜底接口红利换 store 实现service 测试与调用方零改动纪律持锁不做 IO、schema 只加不改、迁移逐版本前进。下一课预告第 19 课《UniFFI 导出核心能力》——把 17-18 课的 core 交给各端UniFFI 生成 Swift/Kotlin/Python 绑定、async 方法导出、复杂类型Session/Message/enum 错误映射、以及如何在壳与 core 之间传回调。这是实战篇的技术主峰。
延伸阅读

更多相关文章

2026/11/19 9:31:32

重庆建网站cqiezscom哪家好?3个坑避开备案难

重庆建网站cqiezscom哪家好?3个坑避开备案难 备案流程一头雾水,直接导致网站上线延期三个月。 别慌,选对重庆建网站cqiezscom哪家好,这问题能省一半精力。 今天把我在行业摸爬滚打10年的经验,拆解给你看。…

2026/11/19 23:10:08

如何预防电工证被冒用到期换证流程

电工证被冒用怎么防?良心建议来了,别让证书过期耽误你发展 证书过期了不知道怎么复审延期?你不是一个人。在平顶山房建工程圈,很多电工因为不了解复审流程,导致证书过期被冒用,甚至丢了工作。这事儿真不是开玩笑的,尤其是现在行业监管越来越严,…

2026/11/19 23:10:08

电工作业防护用品全流程办理指南:考前押题拿证不慌

电工作业防护用品全流程办理指南:考前押题拿证不慌 实操考试心里没底怕挂科,这几乎是每个准备考电工证的学员心里的疙瘩。尤其是电工作业防护用品这类实操性极强的科目,一不小心就可能被扣分甚至挂科。其实,掌握好流程和 考前押题…

2026/11/19 23:10:08

高压电工作业证是几年 上岗必备实操考试别怕挂科

高压电工作业证是几年 上岗必备实操考试别怕挂科 你是不是正在为高压电工作业证的有效期发愁?实操考试心里没底怕挂科,这几乎是每个准备报考特种作业证的人共同的困扰。高压电工作业证是几年有效期?它对你的职业发展有多重要?这篇文章就从实际出发,帮你…

2026/11/19 23:10:08

电工证好难吗官方回应外省证能否转过来

电工证好难吗官方回应外省证能否转过来 之前考的证在外省能不能转过来?这个疑问几乎成了很多准备考电工证人心里的“结”,尤其是在像信阳这样经济发展迅速但又地处中部的城市,很多电工从业者可能是在外地务工时考的证,现在返乡或转岗,证书是否还能继续使…

2026/11/19 23:05:08

辽源建筑电工证复审怎么报名?施工企业负责人必看!

辽源建筑电工证复审怎么报名?施工企业负责人必看! 你是不是正在为“ 辽源建筑电工证复审 ”怎么报名而头疼?别急,今天这篇内容,是给 急需特种作业证才能上岗找工作 的你量身打造的,咱们直接说重点、讲干货,少废话!…

2026/11/19 22:14:34

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/18 21:55:23

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/19 0:04:42

深圳电工证培训考场模拟考试题库:郑州报考避坑指南

深圳电工证培训考场模拟考试题库:郑州报考避坑指南 证书过期了不知道怎么复审延期,很多人在遇到这个问题的时候才意识到特种作业证的重要性。其实,不管是电工证、焊工证还是高处作业证,这些证书不仅是上岗的“通行证”,更是法律对安全操作的硬性要求。尤…

2026/11/19 0:04:42

天津电工证查询入口多少钱能报上名

天津电工证查询入口多少钱能报上名 学历不高怕报不上名?别急,天津电工证查询入口其实没你想的那么难。今天咱们就来聊聊,怎么用最低的门槛、最少的钱,把电工证拿下来,还能查得到、用得上。 电工证到底值不值?先搞清楚它的作用…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/19 17:18:32

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑