unicloud 不提供自动备份功能,因官方未封装定时导出、快照等能力,需开发者用云函数+定时触发器+云存储手动实现;恢复也须手写导入函数,注意权限、类型序列化及日志留存。

uniCloud 数据无法自动备份,官方不提供内置定时快照或自动导出机制,所有备份必须手动触发或自行编码实现。
为什么 uniCloud 没有“自动备份”开关
uniCloud 的数据库(如阿里云 MongoDB、腾讯云 DB)底层是标准云数据库服务,但 uniCloud 控制台和 uniCloud SDK 层面并未封装定时导出、版本快照、binlog 回溯等能力。它只暴露了基础的增删改查和云函数执行入口,备份逻辑完全交由开发者控制。
这意味着:你不能靠点几个按钮就启用“每日凌晨 2 点自动备份”,必须写云函数 + 定时触发器 + 存储介质(如 OSS/COS/云存储)组合实现。
用云函数 + 定时触发器 + 云存储实现备份
这是目前最可行、也最常被采用的方案。核心链路是:定时触发器 → 调用 backupDB 云函数 → 查询全量/增量数据 → 序列化为 JSON 或 BSON → 上传至 uniCloud 提供的 storage(或对接第三方对象存储)。
- 定时触发器需在
uniCloud控制台手动创建,支持 cron 表达式(如0 0 * * *表示每天 0 点) - 云函数内避免直接
db.collection('xxx').get()全表拉取大集合,应分页 +limit/skip或使用where({ _updateTime: db.command.gt(new Date(Date.now() - 24 * 60 * 60 * 1000)) })做增量 - 上传前建议用
JSON.stringify(data, null, 2)格式化,文件名带上时间戳和集合名,例如:user_202606182359.json - 注意
uniCloud云函数单次执行内存上限(默认 256MB)、超时时间(默认 10s,可提至 60s),大数据量必须流式处理或拆分任务
备份文件怎么恢复?没有一键还原命令
uniCloud 不提供类似 mongorestore 的命令行工具或控制台还原入口。恢复只能靠手写云函数反向导入:
- 从
storage下载备份文件(uniCloud.uploadFile对应的是上传,下载用uniCloud.downloadFile) - 用
JSON.parse()解析内容,再调用db.collection('xxx').add({ data: parsedArray })批量写入 - 务必加
try/catch和console.log日志,失败时要记录具体哪条文档出错(比如字段类型不匹配、_id冲突) - 不要在生产环境直接
.set()全量覆盖,优先用.add()或带条件的.update(),避免误删历史数据
容易被忽略的关键细节
真正落地时,90% 的失败不是逻辑写错,而是卡在权限、路径或生命周期上:
-
uniCloud定时触发器默认只触发一次,修改 cron 后必须重新部署并手动“启用”触发器,否则静默失效 - 云函数访问
storage需在uniCloud控制台显式开启“云存储权限”,否则downloadFile报permission denied - 备份 JSON 文件若含
Date、ObjectId等非纯 JSON 类型,直接JSON.stringify会丢失,要用JSON.stringify(doc, (k, v) => v instanceof Date ? { $date: v.toISOString() } : v)处理 - 云函数日志最多保留 7 天,重要备份任务建议把关键状态(如“共备份 1284 条 user 记录”)主动写入一张
backup_log表,方便追溯











