第5篇|时间轨迹的可信存储:敏感数据加密、备份恢复与换机迁移
如果上一篇讲的是“数据应该放在哪里”,那这一篇要继续往前走一步,讲的是:数据放进去之后,怎么让它真的可信。
这里说的“可信”,不是一个很虚的词。它至少包含四件事:
- 数据落盘后不会被轻易看懂
- 不同账号之间不会互相串
- 旧版本升级后还能正常恢复
- 换机、重装、备份导入时还能找回来
也就是说,可信存储不是“多写一个文件”,而是把加密、版本、恢复、迁移这四层一起设计好。
先把当前基础看明白
时间轨迹现在的存储结构其实已经不错了,不是乱写一气。
从代码里能看到几条很清晰的线:
- EntryAbility.ets 负责初始化一堆 PersistentStorage 和 AppStorage
- AccountService.ets 负责保存 session.json、device_accounts.json、accounts/{openId}/userdata.json
- LoginPage.ets 负责登录后加载用户数据、保存会话
- ProfilePage.ets 负责头像、退出登录、用户数据落盘
- EntryAbility.onBackground() 会在应用进入后台时自动保存用户数据
这说明这套应用已经不是“页面上写一点状态”了,而是有了明确的数据层。
但问题也正是在这里出现的:
已经开始存数据了,就必须开始认真对待数据的可信性。
为什么光有沙盒还不够
沙盒能解决的是“数据尽量只留在应用自己的范围里”,但它解决不了下面这些事:
- 用户手机丢了,文件被直接拷走
- 调试包、备份包、导出包里能直接看到明文
- 老版本的 JSON 被新版本读取时报错
- 账号 A 的记录被错误加载到账号 B
- 日志里不小心把敏感字段打印出去了
所以,沙盒只是边界,可信存储才是质量。
换句话说:
- 沙盒回答的是“放哪儿”
- 可信存储回答的是“放进去以后怎么保护、怎么恢复、怎么升级”
先看一张整体图
#mermaid-svg-YHVXTQoIv5bq0aWh{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-YHVXTQoIv5bq0aWh .error-icon{fill:#552222;}#mermaid-svg-YHVXTQoIv5bq0aWh .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-YHVXTQoIv5bq0aWh .marker{fill:#333333;stroke:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh .marker.cross{stroke:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-YHVXTQoIv5bq0aWh p{margin:0;}#mermaid-svg-YHVXTQoIv5bq0aWh .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster-label text{fill:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster-label span{color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster-label span p{background-color:transparent;}#mermaid-svg-YHVXTQoIv5bq0aWh .label text,#mermaid-svg-YHVXTQoIv5bq0aWh span{fill:#333;color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .node rect,#mermaid-svg-YHVXTQoIv5bq0aWh .node circle,#mermaid-svg-YHVXTQoIv5bq0aWh .node ellipse,#mermaid-svg-YHVXTQoIv5bq0aWh .node polygon,#mermaid-svg-YHVXTQoIv5bq0aWh .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .rough-node .label text,#mermaid-svg-YHVXTQoIv5bq0aWh .node .label text,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape .label,#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape .label{text-anchor:middle;}#mermaid-svg-YHVXTQoIv5bq0aWh .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .rough-node .label,#mermaid-svg-YHVXTQoIv5bq0aWh .node .label,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape .label,#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape .label{text-align:center;}#mermaid-svg-YHVXTQoIv5bq0aWh .node.clickable{cursor:pointer;}#mermaid-svg-YHVXTQoIv5bq0aWh .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh .arrowheadPath{fill:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-YHVXTQoIv5bq0aWh .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-YHVXTQoIv5bq0aWh .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-YHVXTQoIv5bq0aWh .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-YHVXTQoIv5bq0aWh .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-YHVXTQoIv5bq0aWh .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster text{fill:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster span{color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-YHVXTQoIv5bq0aWh .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh rect.text{fill:none;stroke-width:0;}#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape p,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape .label rect,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-YHVXTQoIv5bq0aWh .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-YHVXTQoIv5bq0aWh .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-YHVXTQoIv5bq0aWh :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}
AppStorage / PersistentStorage
可信序列化层
加密与完整性校验
文件沙盒 / 账号目录
HUKS 密钥能力
恢复与反序列化
版本检查
数据迁移
回写 AppStorage
导出包 / 备份包
业务页面

这张图里最重要的不是“流程很多”,而是数据从一开始就要被当成一个受保护的对象来处理。
哪些数据值得加密
不是所有东西都必须一刀切上加密,最好按敏感级别分层。
| 高敏感 | 登录会话、账号标识、工作记录、时间地点历史 | 加密 + 完整性校验 |
| 中敏感 | 设备账号列表、头像路径、最近使用记录 | 可加密,也可以做签名校验 |
| 低敏感 | 主题模式、开关偏好、安全区高度 | 可明文保存,但仍建议走统一序列化 |
这里面最值得加密的,不是“看起来复杂”的字段,而是一旦泄露就会暴露用户行为轨迹的字段:
- wrRecords
- wmLocationHistory
- session.json
- customTemplatesJson
- favoriteTemplateIds
- recentTemplateIds
这些内容一旦被直接读到,就不只是“设置文件”,而是用户的行为画像。
当前项目里已经有的好基础
你现在的实现其实已经为可信存储铺好了底子。
1. 数据边界是清楚的
AccountService.saveUserData() 会把当前账号的数据写到:
filesDir/accounts/{openId}/userdata.json
这件事非常重要,因为它意味着:
- 账号数据不是混写的
- 后续可以按账号单独加密
- 迁移和导出也可以按账号处理
2. 会话和业务数据是分开的
session.json 和 userdata.json 不在一个层级里。
这意味着:
- 退出登录可以只清会话
- 数据恢复可以只加载业务内容
- 调试和排错时边界更清楚
3. 后台自动保存已经存在
EntryAbility.onBackground() 里会自动调用 AccountService.saveUserData()。
这说明应用不是等用户手动点“保存”才落盘,而是会在合适时机自动收口。这种设计很适合接“加密保存”,因为你只要把保存入口收紧,后面所有数据都能统一被保护。
真正要补的,是“可信封装层”
我更建议把现在的 JSON 保存,升级成统一的可信封装格式。
可以先想成下面这个结构:
interface TrustedEnvelope {
version: number; // 数据结构版本
namespace: string; // 数据类型,如 session / userdata / accounts
openId: string; // 当前账号标识
algorithm: string; // 加密算法标识
iv: string; // 初始化向量
cipherText: string; // 加密后的正文
tag: string; // 完整性标签
checksum: string; // 可选的校验值
updatedAt: number; // 最后更新时间
}
这个结构最大的价值,不是“看起来高级”,而是它把后面所有问题都提前想好了:
- 版本变更了,怎么识别
- 数据被篡改了,怎么发现
- 重装后恢复时,怎么判断能不能读
- 以后要多账号、多设备同步时,怎么扩展
密钥不要和数据放在一起
可信存储里最忌讳的一件事,就是:
把密钥和密文放在同一个地方,还把它们命名得很像。
那样做本质上只是“把明文换个样子”,不是真正的保护。
更合理的方式是:
HarmonyOS 官方文档里已经有 HUKS 相关的加密、解密和密钥能力说明,这类能力适合用来承接“密钥不落地”的需求。
对应用层来说,你不需要把密钥算法写死在业务里,只需要把“数据加密前后”这层接口收好。
一个更合理的保存流程
我建议把保存流程拆成四步:
// 结构示意,不是直接可运行的最终实现
function saveTrustedUserData(openId: string, data: UserData): void {
const plain = JSON.stringify({
version: 2,
openId,
updatedAt: Date.now(),
payload: data
});
const envelope = encryptWithTrustedKey(plain); // 由安全能力处理密钥
writeText(`filesDir/accounts/${openId}/userdata.enc`, JSON.stringify(envelope));
}
function loadTrustedUserData(openId: string): UserData {
const raw = readText(`filesDir/accounts/${openId}/userdata.enc`);
const envelope = JSON.parse(raw) as TrustedEnvelope;
const plain = decryptWithTrustedKey(envelope);
const parsed = JSON.parse(plain);
return migrateIfNeeded(parsed);
}
这段代码的重点不是具体函数名,而是这条链路:
序列化 -> 加密 -> 落盘 -> 恢复 -> 校验 -> 迁移
只要这条链路清楚了,后面怎么换算法、怎么换字段、怎么做导入导出,都会比较稳。
备份和恢复,才是可信存储真正值钱的地方
很多文章只讲“加密”,但其实对用户来说,更重要的是:
我换手机以后还能不能把东西找回来。
所以可信存储不能只讲保护,还要讲恢复。
推荐的恢复路径
#mermaid-svg-1TIonbotUw1bTien{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-1TIonbotUw1bTien .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-1TIonbotUw1bTien .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-1TIonbotUw1bTien .error-icon{fill:#552222;}#mermaid-svg-1TIonbotUw1bTien .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-1TIonbotUw1bTien .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-1TIonbotUw1bTien .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-1TIonbotUw1bTien .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-1TIonbotUw1bTien .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-1TIonbotUw1bTien .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-1TIonbotUw1bTien .marker{fill:#333333;stroke:#333333;}#mermaid-svg-1TIonbotUw1bTien .marker.cross{stroke:#333333;}#mermaid-svg-1TIonbotUw1bTien svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-1TIonbotUw1bTien p{margin:0;}#mermaid-svg-1TIonbotUw1bTien .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster-label text{fill:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster-label span{color:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster-label span p{background-color:transparent;}#mermaid-svg-1TIonbotUw1bTien .label text,#mermaid-svg-1TIonbotUw1bTien span{fill:#333;color:#333;}#mermaid-svg-1TIonbotUw1bTien .node rect,#mermaid-svg-1TIonbotUw1bTien .node circle,#mermaid-svg-1TIonbotUw1bTien .node ellipse,#mermaid-svg-1TIonbotUw1bTien .node polygon,#mermaid-svg-1TIonbotUw1bTien .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .rough-node .label text,#mermaid-svg-1TIonbotUw1bTien .node .label text,#mermaid-svg-1TIonbotUw1bTien .image-shape .label,#mermaid-svg-1TIonbotUw1bTien .icon-shape .label{text-anchor:middle;}#mermaid-svg-1TIonbotUw1bTien .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .rough-node .label,#mermaid-svg-1TIonbotUw1bTien .node .label,#mermaid-svg-1TIonbotUw1bTien .image-shape .label,#mermaid-svg-1TIonbotUw1bTien .icon-shape .label{text-align:center;}#mermaid-svg-1TIonbotUw1bTien .node.clickable{cursor:pointer;}#mermaid-svg-1TIonbotUw1bTien .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-1TIonbotUw1bTien .arrowheadPath{fill:#333333;}#mermaid-svg-1TIonbotUw1bTien .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-1TIonbotUw1bTien .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-1TIonbotUw1bTien .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-1TIonbotUw1bTien .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-1TIonbotUw1bTien .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-1TIonbotUw1bTien .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-1TIonbotUw1bTien .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .cluster text{fill:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster span{color:#333;}#mermaid-svg-1TIonbotUw1bTien div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-1TIonbotUw1bTien .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-1TIonbotUw1bTien rect.text{fill:none;stroke-width:0;}#mermaid-svg-1TIonbotUw1bTien .icon-shape,#mermaid-svg-1TIonbotUw1bTien .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-1TIonbotUw1bTien .icon-shape p,#mermaid-svg-1TIonbotUw1bTien .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-1TIonbotUw1bTien .icon-shape .label rect,#mermaid-svg-1TIonbotUw1bTien .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-1TIonbotUw1bTien .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-1TIonbotUw1bTien .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-1TIonbotUw1bTien :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}
是
否
用户登录 / 选择账号
读取本地索引
是否存在加密数据
解密
初始化新数据
版本检查
数据迁移
回写 AppStorage
恢复页面状态

恢复这件事一定要分清楚两种情况:
- 本地恢复:同一台设备上重新登录
- 迁移恢复:换机、重装、导入备份包
这两种情况的入口类似,但策略不同。
版本号一定要写
很多本地 JSON 文件一开始都很干净,后来一复杂就开始出问题。
所以我建议任何可信数据都要带版本号。
比如:
{
"version": 2,
"openId": "user_123",
"updatedAt": 1710000000000,
"payload": { … }
}
这样做以后,你就可以很自然地处理:
- version = 1 的旧数据
- version = 2 的新数据
- 某个字段废弃后的兼容
- 某次结构升级后的自动迁移
这也是“可信”很重要的一部分:不只是今天能读,明天也能读。
从“可存”到“可迁移”
如果你真想把这篇做得更像一个系列里的高阶章节,我建议重点强调“迁移”。
因为迁移是最能看出一个项目有没有工程感的地方。
迁移时要考虑的几件事
一个比较稳的思路是:
- 先导入到临时目录
- 校验版本和完整性
- 再迁移到正式账号目录
- 最后才切换到新的索引
这样即使导入失败,也不会把当前可用数据破坏掉。
这套项目现在最适合的升级路线
如果结合你现在的代码,我会这样排优先级:
第一层:先统一封装数据入口
把 saveUserData() / loadUserData() / saveSession() 这几个入口先集中起来,不让文件操作散落到各页面。
第二层:给用户数据加密
优先保护:
- 工作记录
- 地址历史
- 模板收藏
- 设备账号索引
第三层:把导出和恢复做成独立流程
不要让“导出”和“平时保存”共用一套逻辑。
导出是给人看的,平时保存是给应用自己用的,这两者的安全要求不一样。
第四层:补日志脱敏
这一步很容易被忽略,但很关键。
如果日志里直接打印 openId、地址、记录内容,那就算数据本身加密了,泄露也可能从日志里出去。
这一篇想收住的核心结论
时间轨迹走到可信存储这一步,说明它已经不只是一个“能记录”的应用了,而是在往“可长期使用、可换机恢复、可版本演进”的方向走。
我觉得这里最重要的三句话是:
- 沙盒解决的是边界
- 加密解决的是暴露
- 版本和迁移解决的是未来
如果上一篇是在讲“数据放哪儿最合理”,那这一篇就是在讲“数据放进去以后,怎么让用户放心把它留在这里”。
对一个时间轨迹类应用来说,这已经不是小修小补了,而是真正开始有产品底层味道了。

