常见问题与异常处理
=========

#### 应用数据迁移暂停

**问题现象1**

在数据加载界面，应用数据迁移暂停。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c1/v3/jr_m_j0VRLu8hpIJi2oTkQ/zh-cn_image_0000002594828416.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=77602259E483EEC3D41B2A39094663DB7EB5238FD3B25A430C7017D7DD3E4804)

**可能原因**

应用数据迁移的过程中需要使用到网络，当前终端设备网络不可用，导致数据迁移暂停。

**解决方法**

单击“稍后连接WLAN加载”按钮，进入桌面后连接网络，终端设备网络可用后，恢复应用数据迁移。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/80/v3/Yb_bXRYUTw2o8kpWQFlZFg/zh-cn_image_0000002625187863.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=F6CDE2BF07330F71B48E0058CB961262D663A30E2EB914682D4DE4EB40CC030B)

**问题现象2**

进入桌面之后，若应用数据迁移还未结束，可通过通知栏进入应用加载界面查看加载进度

在应用加载界面，应用数据迁移暂停。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a8/v3/Y_qc3p7XQLKWYoeKmfzNuw/zh-cn_image_0000002625108007.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=9E9A2B6A471A5BD5E167535775CEAFF51D868E9AFA5159F85DABDE9DAA42817B)

**可能原因**

应用数据迁移的过程中需要使用到网络，当前终端设备网络不可用，导致数据迁移暂停。

**解决方法**

单击“稍后连接WLAN加载”按钮，进入桌面后连接网络，终端设备网络可用后，恢复应用数据迁移。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/_hT-h5H7R9qlvKwj546E5g/zh-cn_image_0000002594668490.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=78BFE64308130E37F4C409A76321484AAE9ADC9BB5572E837EC0F613C7020851)

#### 应用数据迁移执行十五分钟后失败

**问题现象**

应用数据迁移执行十五分钟后显示失败。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/df/v3/Ch3kRQoNTqWD1LmQrdHb2A/zh-cn_image_0000002625108005.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=A9692A25F475A9ED0E34C137523F7C5FFD24976286CA5CB78EF211D41BF0F973)

**可能原因**

单个应用数据迁移执行超过十五分钟，超过设定的单个应用最长数据迁移时间，任务执行失败。

**解决方法**

请优化应用BackupExtensionAbility的代码实现，在十五分钟内完成应用数据迁移。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/60/v3/vaiQ8_mnS9Sd3kfF__QH8w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=75B21FBA2A14FA4F242F5794BC756EFBC0D216A6BA53605D02350957560F15E5)

已接入“数据迁移框架”的应用完成数据迁移后，才可以被消费者使用。尽可能快的完成应用数据迁移，可以带给消费者更好的体验。

#### 启动迁移按钮无法点击

**问题现象**

在迁移调试界面，输入应用包名后启动迁移按钮无法点亮。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/24/v3/NlLBxSQgRj-OyXEQbUd8tg/zh-cn_image_0000002594828418.png?HW-CC-KV=V1&HW-CC-Date=20260612T073338Z&HW-CC-Expire=86400&HW-CC-Sign=8FF814F701199ECE6D9E07FF02DBF8E0B2DBAD43AEB7E0C3F5DE67823739AE48)

**可能原因**

迁移调试工具版本过低（版本号低于6.0.0.190）。

**解决方法**

请参考[开发者自验证](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/adaptation-process#开发者自验证)下“迁移调试”工具获取方式，申请最新版迁移调试工具。