一、前置思考1.1 存储异常是静默的灾难存储异常不像崩溃那样有错误弹窗往往是悄悄发生、事后才发现场景1: 用户手机空间不足, 数据库写入失败 → 数据丢失无提示 场景2: 应用被杀进程, 文件写入一半 → 文件损坏 场景3: 存储卡异常/系统更新 → 数据库文件损坏 → 启动崩溃 场景4: 磁盘写满 → 图片保存失败 → 用户以为没点保存1.2 存储异常的类型硬件异常: 磁盘坏道、存储卡损坏 (低概率) 系统异常: 空间不足、进程被杀、断电 (中概率) 逻辑异常: 写入中断、版本不兼容、文件被篡改 (高概率)1.3 本文路线建立损坏检测、数据恢复、读写重试、空间预警四道防线让存储异常可发现、可恢复、可兜底。二、核心原理2.1 文件损坏检测机制检测手段: ① 文件头/魔数校验: 读取固定偏移检查格式标识 ② 结构完整性: 遍历校验内部结构 (JSON 解析/数据库 integrity_check) ③ 校验和: 写入时记录 checksum, 读取时对比 ④ 长度校验: 元数据记录的预期大小 vs 实际大小 分级检测: 启动时: 关键文件全量快速校验 读写时: 每次写入带校验 周期: 定时巡检重要数据2.2 数据恢复机制恢复策略: ① 备份恢复: 写入前备份旧文件 (双写/副本) ② 冗余恢复: 关键数据双份存储 ③ 重建恢复: 可重建数据直接重建 (缓存) ④ 修复工具: 数据库 integrity_check 修复导出 恢复优先级: P0 用户数据 (不可重建) → 备份/冗余 P1 业务数据 (半可重建) → 备份 修复 P2 缓存 (可重建) → 直接重建2.3 读写失败重试失败分类: 可重试: IO 忙、空间暂时不足、瞬时错误 不可重试: 文件不存在、权限拒绝、文件损坏 重试策略: 指数退避: 100ms → 200ms → 400ms → 上限 5s 重试次数: 3-5 次 退避上限: 防止无效占用2.4 磁盘空间预警预警等级: 充足: 2GB → 正常 关注: 2GB → 主动清理缓存 告警: 500MB → 停止大文件写入 危险: 100MB → 只读模式 获取空间: 系统 API 查询剩余空间/应用占用三、源码/API 深度解析3.1 文件完整性校验import{fileIoasfs}fromkit.CoreFileKit;import{cryptoFramework}fromkit.CryptoArchitectureKit;// 写入时生成校验和asyncfunctionwriteWithChecksum(path:string,data:Uint8Array):Promisevoid{constmdcryptoFramework.createMd(SHA256);awaitmd.update({data:data});constdigestawaitmd.digest();constchecksumArray.from(digest.data).map(bb.toString(16).padStart(2,0)).join();// 写入数据 元数据(checksum, size)constfilefs.openSync(path,fs.OpenMode.READ_WRITE|fs.OpenMode.CREATE|fs.OpenMode.TRUNC);fs.writeSync(file.fd,data.buffer);fs.closeSync(file.fd);// 元数据存 KV: path - { checksum, size }}// 读取时校验asyncfunctionreadWithVerify(path:string):PromiseUint8Array|null{try{constfilefs.openSync(path,fs.OpenMode.READ_ONLY);conststatfs.statSync(path);constbufnewArrayBuffer(stat.size);fs.readSync(file.fd,buf);fs.closeSync(file.fd);// 重新计算 checksum 对比元数据constdatanewUint8Array(buf);constchecksumawaitcalcChecksum(data);if(checksum!getMetaChecksum(path)){returnnull;// 损坏}returndata;}catch(e){returnnull;}}3.2 数据库完整性检查与修复import{relationalStore}fromkit.ArkData;// 启动时完整性检查asyncfunctioncheckDbIntegrity(rdb:relationalStore.RdbStore):Promiseboolean{try{constrsawaitrdb.querySql(PRAGMA integrity_check);letokfalse;if(rs.goToFirstRow()){okrs.getString(0)ok;}rs.close();returnok;}catch(e){returnfalse;}}// 数据库备份 (写入前)functionbackupDb(dbPath:string):string{constbakdbPath.bak;try{fs.copyFileSync(dbPath,bak);}catch(e){/* 忽略 */}returnbak;}// 损坏恢复流程asyncfunctionrecoverDb(rdbPath:string):Promiseboolean{// 1. 尝试打开备份constbakrdbPath.bak;if(fs.accessSync(bak)){// 2. 用备份替换损坏库fs.unlinkSync(rdbPath);fs.copyFileSync(bak,rdbPath);returntrue;}// 3. 无备份: 尝试导出可读数据重建returnfalse;}3.3 读写失败重试封装// 通用重试器asyncfunctionwithRetryT(task:()PromiseT,retries3,baseDelayMs100):PromiseT{letlastErr:Error|nullnull;for(leti0;iretries;i){try{returnawaittask();}catch(e){lastErreasError;consterreas{code?:number};// 不可重试错误直接抛出if(isFatalError(err.code)){throwe;}awaitsleep(baseDelayMs*Math.pow(2,i));// 指数退避}}throwlastErr;}functionisFatalError(code?:number):boolean{// 不可重试: 文件不存在(2) / 权限拒绝(13) / 损坏returncode2||code13;}3.4 空间预警import{statfs}fromkit.CoreFileKit;interfaceSpaceInfo{freeBytes:number;totalBytes:number;usedPct:number;}functiongetSpaceInfo():SpaceInfo{// 查询数据目录所在分区的空间conststatstatfs(/data);constfreeBytesstat.freeBlocks*stat.blockSize;consttotalBytesstat.totalBlocks*stat.blockSize;return{freeBytes:freeBytes,totalBytes:totalBytes,usedPct:Math.round((totalBytes-freeBytes)/totalBytes*100)};}functionspaceLevel(info:SpaceInfo):OK|LOW|CRITICAL{if(info.freeBytes100*1024*1024){returnCRITICAL;}if(info.freeBytes500*1024*1024){returnLOW;}returnOK;}四、企业级实战落地4.1 存储异常防御体系┌──────────────────────────────────────────┐ │ 预防层: │ │ 写入前备份 · 双写冗余 · 磁盘空间监控 │ ├──────────────────────────────────────────┤ │ 检测层: │ │ 启动完整性检查 · 读写校验和 · 周期巡检 │ ├──────────────────────────────────────────┤ │ 恢复层: │ │ 备份恢复 → 修复工具 → 重建 → 提示用户 │ ├──────────────────────────────────────────┤ │ 兜底层: │ │ 重试退避 · 降级模式 · 错误上报 │ └──────────────────────────────────────────┘4.2 数据库启动检查流程启动 → 打开数据库 ├─ integrity_check ok → 正常使用 ├─ 损坏 有备份 → 恢复备份 → 提示用户 ├─ 损坏 无备份 → 导出可读数据 → 重建 → 提示 └─ 无法修复 → 只读模式 错误上报4.3 文件写入保护写入保护规则: 关键数据: 写临时文件 → fsync → 校验 → rename 覆盖 (原子替换) 缓存数据: 直接写, 损坏可重建 图片等: 写入后校验大小 文件头4.4 异常上报与监控异常上报内容处置文件损坏路径/类型/校验失败统计损坏率空间不足剩余空间/操作主动清理写入失败错误码/重试次数定位根因数据库损坏版本/备份有无评估恢复成功率五、问题排查与性能优化坑现象原因解决启动崩溃数据库打不开文件损坏integrity_check 备份恢复写入静默失败数据丢失无错误处理写入检查返回值图片损坏打不开写入中断原子替换 校验空间不足崩溃保存失败未监控空间空间预警 降级重复重试卡顿无限重试指数退避 上限备份失效恢复失败备份损坏双份备份 校验缓存重建风暴启动全重建缓存无校验分级重建5.1 原子写入防半写文件// 原子替换: 写临时 → 校验 → renameasyncfunctionatomicWrite(path:string,data:Uint8Array):Promisevoid{consttmpPathpath.tmp;constfilefs.openSync(tmpPath,fs.OpenMode.READ_WRITE|fs.OpenMode.CREATE|fs.OpenMode.TRUNC);fs.writeSync(file.fd,data.buffer);fs.fsyncSync(file.fd);// 刷盘fs.closeSync(file.fd);// rename 原子替换 (同文件系统内)fs.renameSync(tmpPath,path);}5.2 分级恢复策略P0 用户数据: 双写冗余 (主 备份) → 主损坏用备份 P1 业务数据: 定期备份 → 损坏用备份 P2 缓存: 不备份 → 损坏直接重建5.3 空间预警联动空间 500MB: ① 清理 cache 目录 ② 清理过期文件 ③ 停止大文件写入 空间 100MB: ① 进入只读模式 ② 提示用户清理 ③ 重要数据立即备份六、高阶总结与最佳实践预防 检测 恢复写入前备份、原子替换把损坏概率降到最低。四道检测文件头、结构校验、checksum、长度——启动与写入时都查。分级恢复P0 双写冗余、P1 定期备份、P2 直接重建。重试要退避指数退避 上限不可重试错误直接抛。空间要预警分级响应从主动清理到只读模式避免写入失败静默丢数据。一句话记住写前备份、写时校验、坏后恢复、满前预警——存储异常不可怕可怕的是发现不了、恢复不了、兜底不了。