背景说明
- 自 2026 年 11 月 1 日起,uniCloud 不再支持新建阿里云服务空间。
- 现有阿里云服务空间将于 2027 年 9 月 30 日停止服务。
- 详见 uniCloud 阿里云服务空间渐进式下线公告及平滑迁移方案 公告。
为了方便开发者将业务从阿里云服务空间迁移到其他云,我们提供了一键迁移的功能,开发者可在uniCloud web 控制台操作迁移。
开发者可以按业务模块迁移阿里云服务空间中的资源:
| 模块 | 可迁移内容 |
|---|---|
| 云数据库 | 选择备份中的数据表、数据和索引,可迁移到目标空间的内置数据库或扩展数据库 |
| 云存储 | 云存储中的文件及目录结构,可迁移到目标空间的内置云存储或扩展存储 |
| 前端网页托管 | 前端网页托管中的文件及目录结构,可迁移到目标空间的内置前端网页托管或扩展存储 |
| 云函数&公共模块 | 云函数、公共模块、schema、环境变量、定时任务配置及相关插件授权等 |
由于数据库schema的场景应用在云函数中,所以会跟随函数进行迁移,另外以下资源会在“云函数&公共模块”任务中按条件一并处理:
每个业务模块需要分别配置和提交迁移。这样做虽然多了几次确认,但好处是每个模块都有自己的进度和日志,某个业务模块失败时也不会拖着其他业务模块一起重来。
推荐按照云数据库、云存储、前端网页托管、云函数和公共模块的业务顺序进行迁移。先迁移被云函数依赖的数据和文件,最后迁移云函数、定时任务及关联资源。
四个业务模块仍然相互独立,可以根据实际业务自由切换和提交。
同时一键迁移还提供“停服维护”功能,用于在最终迁移和业务切换期间拦截源阿里云空间的云函数及云对象请求。
注意:
先在当前账号下创建一个支付宝云或腾讯云服务空间,正式开始前,建议做如下检查:
一键迁移入口在阿里云服务空间中:

首次迁移前,要先为当前阿里云空间绑定一个目标服务空间。

未提交迁移任务前,仍可切换绑定空间,在目标空间中选择其他服务空间后,点击“切换绑定空间”来换绑

首次成功提交迁移任务后绑定已锁定,不再支持更换目标空间,如需调整请前往阿里云服务空间迁移指南uni-im群中联系管理员申请。

注意:
迁移任务提交后会在云端自动执行,离开页面或关闭浏览器不会中断。再次进入页面后,可以继续查看最新进度和日志。每个业务模块都会保留最近一次迁移任务的日志。
迁移任务可能处于以下状态:
| 状态 | 说明 |
|---|---|
| 等待执行 | 任务已提交,正在等待云端执行 |
| 执行中 | 正在迁移资源 |
| 已成功 | 任务已经执行完成,接下来需要验证目标空间 |
| 已失败 | 部分或全部资源迁移失败,可以从失败项和日志开始排查 |
| 已取消 | 主动取消了任务,已经写入目标空间的内容不会回滚 |
每个迁移任务都有唯一的任务ID。任务执行过程中会记录详细的日志及任务进度,以便更好的了解任务执行到哪一步。
如果迁移过程出现失败,您也可以从日志中看到具体错误信息。

执行中的任务可以取消,但“取消”不等于“撤销”。它只会停止后续处理,已经写入目标空间的资源会保留。
所以,任务取消后如果准备重新迁移,建议先将目标服务空间已迁移资源删除。
当前不支持迁移任务失败或取消后从中断位置继续。点击“重新迁移”只会恢复上一次任务的主要配置,重新提交后会创建新任务,并从头执行当前业务模块的迁移。
对于部分特定失败,页面可能提供“重试失败定时任务”“重试失败文件”或“重新打包”等局部处理入口,这些操作只处理对应失败项。
阿里云会在凌晨备份前一天的数据,由于整体量级较大,有的空间在阿里云测备份执行较早,备份完成的时间也会早一些,一般会在凌晨5~7点完成。
迁移任务迁移的是阿里云空间已有备份里的数据,数据备份日当天发生的新增和修改不会迁移,所以应当安排好停服维护的逻辑和时间。
在“云数据库”页签中选择以下一种目标:
如果选择扩展数据库,还需选择对应的数据库名称。如果扩展数据库列表为空,通常是目标空间还没有获得扩展数据库授权,可以参考授权绑定空间先完成授权后再回来继续操作。

切换备份时间后,页面会重新读取该备份包含数据表。

如果数据里保存了阿里云服务空间的资源链接,可以使用过滤规则顺手替换,最多可设置五组。
例如,数据库中保存了阿里云云存储文件的完整 URL,可以将阿里云云存储域名替换为目标空间的新域名。
过滤规则只处理数据内容里的字符串,不会重命名数据表或字段。这里的替换会真正写入目标数据库,提交前务仔细必核,该操作会增加一定迁移时长。

注意
如果内置云存储容量较大且文件数量较多(如容量10GB以上且小文件居多),该迁移工具会非常耗时,建议通过扩展存储回源的方式将内置云存储迁移至扩展存储,费用相较内置存储也会降低,点击查看文档 并参考其中的“方案二”。
内置云存储支持迁移至目标服务空间内置云存储或扩展存储,文件会按原目录结构上传到目标位置。
在“云存储”页签中选择:
只有目标空间存在可用扩展存储时,才能选择“扩展存储”。
开启“打包上传”后,系统会在迁移文件的同时生成 ZIP 分卷:
unicloud-aliyun-migration-*.zip;打包不是迁移文件的必要条件。只有确实需要在迁移后下载一份归档时再开启,否则保持关闭可以节省时间和目标空间容量。

HBuilderX 发行 Web 时生成的是编译产物,会包含原阿里云服务空间 ID。直接复制旧编译产物到目标空间后,页面仍无法请求到新空间。其他非编译产物的静态资源(如图片)可正常访问。
所以迁移完成后,需在 HBuilderX 中把项目关联到目标空间,重新发行 Web并上传前端网页托管。
在“前端网页托管”页签中选择:
如果目标空间是支付宝云,还要留意路由模式:支付宝云前端网页托管不支持 history 模式。项目当前使用 history 模式时,可以改为 hash 模式,或者把扩展存储作为迁移目标,详见扩展存储托管 Web 静态站点说明。
前端网页托管的打包规则与云存储一致:开启后会在目标位置根目录生成约 900 MB 的 unicloud-aliyun-migration-*.zip 分卷,并额外占用容量。
“云函数&公共模块”建议放在最后迁移,因为它不仅涉及代码,还要处理运行依赖、插件授权、定时任务和部分空间关联配置。通常把数据库、云存储和网页托管准备好之后,再做这个模块会更稳妥。
如果您的阿里云服务空间开通了激励视频回调功能,
uniAdCallback云函数迁移新空间后无法直接使用,因为广告位配置关联的仍是阿里云服务空间,需要在uni-ad控制台创建新的广告位来关联新空间,该操作会自动更新新空间的激励视频回调配置。
该操作会先做一次资源检测,看看哪些内容能直接迁、哪些内容需要你先处理:
检测只是“体检”,不会修改阿里云服务空间或目标空间,也不会创建迁移任务,可以放心执行。
检测结果可能包含:
如果检测结果里出现无法读取或解析的定时任务配置,先通过阿里云服务空间修正配置后再重新检测。

定时任务运行空间支持多选:
页面默认只选择新空间,至少要保留一个选项。选择时请注意:
如果阿里云服务空间开通了扩展存储,并且目标空间未开通扩展存储,页面会显示“转移扩展存储”开关。开启后:
转移执行期间,不要在控制台操作两个空间的扩展存储。如果目标空间已经存在扩展存储绑定,将不能接收转移。如需转移,请先销毁目标空间的扩展存储。
阿里云空间如果开通了包年包月 Redis,且目标空间是支付宝云空间时(需未开通Redis),页面会显示“转移 Redis”开关。开启后:
如果 Redis 已开启自动续费,转移时会先关闭。任务完成后可操作重新开启。
这部分不需要额外设置,迁移任务会自动处理阿里云空间已经配置的业务白名单,并将目标空间添加到白名单中,涉及到的业务有:
没有配置白名单,或配置中没有待迁移的阿里云服务空间时,不做处理。系统只会追加目标空间,不会删掉原空间。

在迁移过程中,如果需要拦截云函数/云对象的请求,不触发函数逻辑执行,可以使用该功能。
开启后,阿里云空间的云函数和云对象请求会被统一拦截,业务代码不会继续执行,表现如下:

任务执行期间,函数会逐个更新,因此可能出现部分请求已经被拦截、部分请求仍可正常执行的短暂状态。需要依赖停服维护控制数据写入时,务必等任务全部成功后再进行下一步。
此时函数被请求时,success为false,response中会包含对应的维护提示语:
{
"success": false,
"error": {
"code": "FunctionBizError",
"message": "系统维护中,请稍后再试"
}
}
需要恢复阿里云空间云函数请求时:
关闭任务同样会逐个更新函数。任务完成前,可能有部分函数已经恢复、部分函数仍返回维护提示语。
关闭后系统会保留上一次维护提示语,之后再次开启时可以直接复用;在关闭状态下只修改提示语时,只保存配置,不会创建函数更新任务。
页面显示任务成功,只代表该任务配置的资源已经处理完成。切换业务前,建议先在目标空间核对迁移结果:
一键迁移任务完成后,还需要进行客户端升级、域名和第三方配置修改、业务测试及流量切换。这些内容请继续按照uniCloud 阿里云服务空间迁移公告中的“执行迁移后检查及配置”和“注意事项”完成。
不能。云函数&公共模块、云数据库、云存储和前端网页托管需要分别提交。这样可以按业务依赖安排顺序,某个业务模块失败时也能单独处理。
不会。迁移任务在云端执行,关闭浏览器或切换到其他页面都不影响。之后再回到这个页面,进度和日志还在。
不会。点击“重新迁移”只会恢复原任务的主要配置,重新提交后会创建新任务,并从头执行当前业务模块。只有页面明确提供的“重试失败定时任务”“重试失败文件”或“重新打包”属于局部处理。
不会。已经写入目标空间的资源会保留。
不能。目标空间必须由当前登录账号创建并拥有。即使当前账号拥有协作空间的管理权限,该空间也不能作为迁移目标。
不能。首次成功提交任意业务模块任务后,目标空间绑定就会锁定;取消或失败也不会解锁。
数据库迁移使用的是所选备份。备份完成后产生的数据不会进入这次任务。可以在维护窗口内停止写入,再选择最终备份进行迁移。
云存储和前端网页托管遇到同名文件时会直接覆盖,不进行内容比对,也不会自动保留旧版本。
不会。原实例、数据、地域和公网地址都保持不变。。
可以继续通过原空间云函数访问。转移后扩展存储改由目标空间管理,但迁移流程会保留原空间云函数的访问能力。
它会在目标空间留下一份便于下载的迁移归档。如果没有下载归档的需求,可以不开启;它不是迁移必需项,还会额外占用容量和执行时间。