• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 元能力子系统错误码
2
3> **说明:**
4>
5> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。
6
7## 16000001 指定的Ability名称不存在
8
9**错误信息**
10
11The specified ability does not exist.
12
13**错误描述**
14
15当指定的Ability名称不存在时,方法将返回该错误码。
16
17**可能原因**
18
19所查询的Ability不存在。
20
21**处理步骤**
22
231. 检查want中的bundleName、moduleName和abilityName是否正确。
242. 检查传入want中bundleName对应的应用是否安装。可使用如下命令查询已安装的应用列表,若bundleName不在查询结果中,说明应用未安装成功。
25    ```
26    hdc shell bm dump -a
27    ```
283. 多hap应用需确认ability所属的hap是否已被安装。可使用如下命令查询应用的包信息,若安装的应用中没有对应的hap和ability,说明ability所属的hap未被安装。
29    ```
30    hdc shell bm dump -n 包名
31    ```
32
33## 16000002 接口调用Ability类型错误
34
35**错误信息**
36
37Incorrect ability type.
38
39**错误描述**
40
41当接口调用Ability类型错误时,方法将返回该错误码。
42
43**可能原因**
44
45接口调用所在的Ability类型不支持该接口调用。
46
47**处理步骤**
48
491. 检查want中的bundleName、moduleName和abilityName是否正确。
502. 根据Ability类型调用不同接口,如ServiceExtensionAbility应使用<!--Del-->[startServiceExtensionAbility](js-apis-inner-application-uiAbilityContext-sys.md#uiabilitycontextstartserviceextensionability)方法启动或<!--DelEnd-->[connectServiceExtensionAbility()](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法连接。
51
52## 16000003 指定的ID不存在
53
54**错误信息**
55
56The specified ID does not exist.
57
58**错误描述**
59
60当指定的ID不存在时,方法将返回该错误码。
61
62**可能原因**
63
64操作的目标ID不存在。
65
66**处理步骤**
67
68确认操作的ID是否存在。
69
70## 16000004 可见性校验失败
71
72**错误信息**
73
74Failed to start the invisible ability.
75
76**错误描述**
77
78当可见性校验失败时,方法将返回该错误码。
79
80**可能原因**
81
82应用可见性校验失败。
83
84**处理步骤**
85
861. Stage模型下,拉起应用时抛出16000004异常,表示被拉应用调用失败,需要检查被拉应用module.json5的Ability字段的[exported](../../quick-start/module-configuration-file.md#abilities标签)配置是否为true。该配置字段为true,表示可以被其他应用调用;该配置字段为false,表示不可以被其他应用调用。
872. 若应用需要拉起exported为false的ability,请申请ohos.permission.START_INVISIBLE_ABILITY权限(该权限仅系统应用可申请)。
88
89## 16000005 指定的进程权限校验失败
90
91**错误信息**
92
93The specified process does not have the permission.
94
95**错误描述**
96
97当指定的进程权限校验失败时,方法将返回该错误码。
98
99**可能原因**
100
101指定的进程权限校验失败。
102
103**处理步骤**
104
105确认指定进程的权限是否正确。
106
107## 16000006 不允许跨用户操作
108
109**错误信息**
110
111Cross-user operations are not allowed.
112
113**错误描述**
114
115当应用跨用户操作时,方法将返回该错误码。
116
117**可能原因**
118
119应用进行了跨用户操作。
120
121**处理步骤**
122
123确认是否进行了跨用户操作。
124
125## 16000007 服务繁忙
126
127**错误信息**
128
129Service busy. There are concurrent tasks. Try again later.
130
131**错误描述**
132
133当服务繁忙时,方法将返回该错误码。
134
135**可能原因**
136
137服务繁忙。
138
139**处理步骤**
140
141服务繁忙,请稍后重试。
142
143## 16000008 众测应用到期
144
145**错误信息**
146
147The crowdtesting application expires.
148
149**错误描述**
150
151当众测应用到期时,方法将返回该错误码。
152
153**可能原因**
154
155众测应用到期,无法打开。
156
157**处理步骤**
158
159请检查应用是否众测到期,已过有效期的众测应用无法启动。
160
161## 16000009 wukong模式,不允许启动/停止ability
162
163**错误信息**
164
165An ability cannot be started or stopped in Wukong mode.
166
167**错误描述**
168
169当wukong模式下,启动/停止ability时,方法将返回该错误码。
170
171**可能原因**
172
173wukong模式,不允许启动/停止ability。
174
175**处理步骤**
176
177退出wukong模式后,再尝试启动/停止ability。请勿在wukong模式下启动/停止Ability。
178
179## 16000010 不允许带迁移flag
180
181**错误信息**
182
183The call with the continuation flag is forbidden.
184
185**错误描述**
186
187当调用携带迁移flag时,方法将返回该错误码。
188
189**可能原因**
190
191当前调用不允许携带迁移flag。
192
193**处理步骤**
194
195请检查是否携带迁移flag。
196
197## 16000011 上下文对象不存在
198
199**错误信息**
200
201The context does not exist.
202
203**错误描述**
204
205当上下文对象不存在时,方法将返回该错误码。
206
207**可能原因**
208
209当前上下文对象不存在。
210
211**处理步骤**
212
213请检查上下文对象是否可用。
214
215## 16000012 应用被管控
216
217**错误信息**
218
219The application is controlled.
220
221**错误描述**
222
223当应用受到应用市场管控时,方法将返回该错误码。
224
225**可能原因**
226
227应用疑似存在恶意行为,受到应用市场管控不允许启动。
228
229**处理步骤**
230
231建议卸载该应用。
232
233## 16000013 应用被EDM管控
234
235**错误信息**
236
237The application is controlled by EDM.
238
239**错误描述**
240
241当应用受到企业设备管理[Enterprise Device Manager](../../mdm/mdm-kit-admin.md)管控时,方法将返回该错误码。
242
243**可能原因**
244
245应用受企业设备管理管控。
246
247**处理步骤**
248
249请联系企业设备管理相关人员。
250
251## 16000015 服务超时
252
253**错误信息**
254
255Service timeout.
256
257**错误描述**
258
259当服务超时时,方法将返回该错误码。
260
261**可能原因**
262
263服务超时。
264
265**处理步骤**
266
267服务超时,请稍后重试。
268
269## 16000017 上一个Ability未启动完成,先缓存在队列中等待后续启动
270
271**错误信息**
272
273Another ability is being started. Wait until it finishes starting.
274
275**错误描述**
276
277需要启动的Ability过多,由于系统处理能力有限,会先将请求缓存在队列中,按照顺序依次处理。
278
279**可能原因**
280
281系统并发大。
282
283**处理步骤**
284
285无需处理,等待启动即可。
286
287## 16000018 限制API 11以上版本三方应用跳转
288
289**错误信息**
290
291Redirection to a third-party application is not allowed in API version 11 or later.
292
293**错误描述**
294
295当应用API版本大于11的时候,不允许显式跳转到其他三方应用。
296
297**处理步骤**
298
299使用隐式启动方式或通过[openLink](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextopenlink12)跳转其他应用。
300
301## 16000019 隐式启动未查找到匹配应用
302
303**错误信息**
304
305No matching ability is found.
306
307**错误描述**
308
309隐式启动无法查找到匹配的Ability。
310
311**可能原因**
312
3131. 隐式启动的参数配置有误。
3142. 指定的HAP包未安装。
315
316**处理步骤**
317
3181. 确保隐式启动的参数配置正确。
3192. 确保对应的HAP包已安装。
320
321## 16000050 内部错误
322
323**错误信息**
324
325Internal error.
326
327**错误描述**
328
329当内存申请、多线程处理异常等内部处理错误时,方法将返回该错误码。
330
331**可能原因**
332
333内存申请、多线程处理等内核通用错误。具体原因可能包括:内部对象为空、处理超时、包管理获取应用信息失败、系统服务获取失败、启动的ability实例已达到上限等等。
334
335**处理步骤**
336
3371. 确认系统内存是否足够,设备使用的系统版本是否存在异常。
3382. 检查是否启动了过多的ability。
3393. 尝试重启设备。
340
341## 16000051 网络异常
342
343**错误信息**
344
345Network error.
346
347**错误描述**
348
349当网络异常时,方法将返回该错误码。
350
351**可能原因**
352
353网络不可用。
354
355**处理步骤**
356
357网络异常,请稍后重试,或者重连网络尝试。
358
359## 16000052 不支持免安装
360
361**错误信息**
362
363Installation-free is not supported.
364
365**错误描述**
366
367当前应用不支持免安装时,方法将返回该错误码。
368
369**可能原因**
370
371应用包不满足免安装要求,如包大小超过限制等。
372
373**处理步骤**
374
375请检查应用是否支持免安装。
376
377## 16000053 非顶层应用
378
379**错误信息**
380
381The ability is not on the top of the UI.
382
383**错误描述**
384
385当前应用未显示在界面顶层时,方法将返回该错误码。
386
387**可能原因**
388
389用户执行免安装启动时需要确保应用在前台,但应用未显示在界面顶层。
390
391**处理步骤**
392
393请检查当前应用是否显示在界面顶层。
394
395## 16000054 免安装服务繁忙
396
397**错误信息**
398
399The installation-free service is busy. Try again later.
400
401**错误描述**
402
403当免安装服务繁忙时,方法将返回该错误码。
404
405**可能原因**
406
407已有相同原子化服务的下载安装任务在执行。
408
409**处理步骤**
410
411免安装服务繁忙,请稍后重试。
412
413## 16000055 免安装超时
414
415**错误信息**
416
417Installation-free timed out.
418
419**错误描述**
420
421当免安装超时时,方法将返回该错误码。
422
423**可能原因**
424
425免安装超时。
426
427**处理步骤**
428
429免安装超时,请稍后重试。
430
431## 16000056 不允许免安装其他应用
432
433**错误信息**
434
435Installation-free is not allowed for other applications.
436
437**错误描述**
438
439当免安装其他应用时,方法将返回该错误码。
440
441**可能原因**
442
443不允许免安装其他应用。
444
445**处理步骤**
446
447确认免安装的是正确的应用。
448
449## 16000057 不支持跨设备免安装
450
451**错误信息**
452
453Cross-device installation-free is not supported.
454
455**错误描述**
456
457当持跨设备免安装时,方法将返回该错误码。
458
459**可能原因**
460
461不支持跨设备免安装。
462
463**处理步骤**
464
465确认为非跨设备免安装应用。
466
467## 16000058 指定的URI flag无效
468
469**错误信息**
470
471Invalid URI flag.
472
473**错误描述**
474
475指定的URI flag无效。
476
477**可能原因**
478
479传入的参数有误。
480
481**处理步骤**
482
483确认传入的参数属于Uri flag。
484
485## 16000059 指定的URI类型无效
486
487**错误信息**
488
489Invalid URI type.
490
491**错误描述**
492
493指定的URI类型无效。
494
495**可能原因**
496
497传入的参数有误,目前URI授权管理仅支持file类型URI。
498
499**处理步骤**
500
501确认传入的参数属于支持的URI类型。
502
503## 16000060 不支持沙箱应用授权URI
504
505**错误信息**
506
507A sandbox application cannot grant URI permission.
508
509**错误描述**
510
511当沙箱应用授权URI时,方法将返回该错误码。
512
513**可能原因**
514
515不支持沙箱应用授权URI。
516
517**处理步骤**
518
519确认为非沙箱应用。
520
521## 16000061 不支持的操作
522
523**错误信息**
524
525Operation not supported.
526
527**错误描述**
528
529当操作在当前系统上不支持时,返回该错误码。
530
531**可能原因**
532
533操作在当前系统上不支持。
534
535**处理步骤**
536
537确认操作在当前系统上是否支持。
538
539## 16000062 子进程数量超出上限
540
541**错误信息**
542
543The number of child processes exceeds the upper limit.
544
545**错误描述**
546
547当申请创建子进程时,创建的子进程数量已经达到上限,返回该错误码。
548
549**可能原因**
550
551创建的子进程数量已经达到上限。
552
553**处理步骤**
554
555确认创建的子进程数量是否已经达到上限。子进程数量上限为512个。
556
557## 16000063 重启应用指定组件无效
558
559**错误信息**
560
561The target to restart does not belong to the current application or is not a UIAbility.
562
563**错误描述**
564
565当重启应用拉起指定组件时,指定组件名称或类型无效,返回该错误码。
566
567**可能原因**
568
569指定组件名称或类型无效。
570
571**处理步骤**
572
573确认指定组件名称为当前应用组件,且类型为UIAbility。
574
575## 16000064 重启应用频繁
576
577**错误信息**
578
579Restart too frequently. Try again at least 3s later.
580
581**错误描述**
582
583当重启应用拉起指定组件时,3s内再次调用,返回该错误码。
584
585**可能原因**
586
587调用接口频繁。
588
589**处理步骤**
590
591间隔3s后再次调用。
592
593## 16000065 接口只支持Ability在前台时调用
594
595**错误信息**
596
597The API can be called only when the ability is running in the foreground.
598
599**错误描述**
600
601当Ability不在前台时,方法将返回该错误码。
602
603**可能原因**
604
605调用接口时,Ability不在前台。
606
607**处理步骤**
608
609将Ability切换到前台后,再调用接口。
610
611## 16000066  wukong模式,不允许移动Ability到前台/后台
612
613**错误信息**
614
615An ability cannot switch to the foreground or background in Wukong mode.
616
617**错误描述**
618
619当wukong模式下,移动Ability到前台/后台时,方法将返回该错误码。
620
621**可能原因**
622
623wukong模式,不允许移动Ability到前台/后台。
624
625**处理步骤**
626
627退出wukong模式后,再尝试移动Ability到前台/后台。请勿在wukong模式下移动Ability到前台/后台。
628
629## 16000067 Ability启动参数校验失败
630
631**错误信息**
632
633The StartOptions check failed.
634
635**错误描述**
636
637当StartOptions相关的参数校验失败时,返回该错误码。
638
639**可能原因**
640
6411. 调用startAbility时,processMode设置为NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM或者ATTACH_TO_STATUS_BAR_ITEM,但是应用在状态栏没有图标,则返回该错误码。
6422. 调用showAbility/hideAbility时,如果调用方不是以NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM或者ATTACH_TO_STATUS_BAR_ITEM模式启动,则返回该错误码。
643
644**处理步骤**
645
646确认StartOptions参数配置,以及相应的约束条件是否满足。
647
648## 16000068 Ability已经在运行中
649
650**错误信息**
651
652The ability is already running.
653
654**错误描述**
655
656当目标Ability已经在运行中时,返回该错误码。
657
658**可能原因**
659
660调用startAbility时,指定了processMode和startupVisibility,目标Ability的launchType是singleton或者specified,并且目标Ability正在运行中,则返回该错误码。
661
662**处理步骤**
663
664当目标Ability的launchType是singleton或者specified时,避免通过指定processMode和startupVisibility的方式重复startAbility。
665
666## 16000069 严格模式下不允许该类型Extension启动三方应用
667
668**错误信息**
669
670The extension cannot start the third party application.
671
672**错误描述**
673
674严格模式下,不允许该类型Extension启动三方应用。
675
676**可能原因**
677
678当前Extension处于严格模式,且对应的Extension类型不允许严格模式下启动其他三方应用。
679
680**处理步骤**
681
6821. 查看[对应Extension类型](../../application-models/extensionability-overview.md)严格模式开启条件。
6832. 以非严格模式启动当前Extension。
684
685## 16000070 严格模式下不允许该类型Extension启动指定ServiceExtensionAbility
686
687**错误信息**
688
689The extension cannot start the service.
690
691**错误描述**
692
693严格模式下,不允许该类型Extension启动指定ServiceExtensionAbility。
694
695**可能原因**
696
697当前Extension处于严格模式,且对应的Extension类型不允许严格模式下启动指定ServiceExtensionAbility。
698
699**处理步骤**
700
7011. 查看[对应Extension类型](../../application-models/extensionability-overview.md)严格模式开启条件。
7022. 以非严格模式启动当前Extension。
703
704## 16000071 不支持应用分身模式
705
706**错误信息**
707
708App clone is not supported.
709
710**错误描述**
711
712当应用不支持分身模式时,返回该错误码。
713
714**可能原因**
715
716该应用没有在app.json5配置文件[multiAppMode](../../quick-start/app-configuration-file.md#multiappmode标签)标签中配置应用分身字段,导致该应用不支持分身模式,调用[getCurrentAppCloneIndex](./js-apis-inner-application-applicationContext.md#applicationcontextgetcurrentappcloneindex12)接口时返回该错误码。
717
718**处理步骤**
719
720参考[应用多实例的配置方法](../../quick-start/multiInstance.md#应用多实例的配置方法),在app.json5配置文件中配置multiAppMode标签,开启应用分身功能后,再调用[getCurrentAppCloneIndex](./js-apis-inner-application-applicationContext.md#applicationcontextgetcurrentappcloneindex12)接口。
721
722<!--Del-->
723## 16000072 不支持应用多开
724
725**错误信息**
726
727App clone or multi-instance is not supported.
728
729**错误描述**
730
731当应用不支持多开时,返回该错误码。
732
733**可能原因**
734
735调用getRunningMultiAppInfo查询不支持应用多开的应用多开信息,则返回该错误码。
736
737**处理步骤**
738
739调用getCurrentAppCloneIndex时确保查询的应用支持应用多开。
740<!--DelEnd-->
741
742## 16000073 传入的appCloneIndex是一个无效值
743
744**错误信息**
745
746The app clone index is invalid.
747
748**错误描述**
749
750传入一个无效的appCloneIndex,返回该错误码。
751
752**可能原因**
753
7541.调用startAbility时,使用ohos.extra.param.key.appCloneIndex携带的appCloneIndex是一个无效值,则返回该错误码。
755<!--Del-->
7562.调用isAppRunning是,入参appCloneIndex是一个无效值,则返回该错误码。
757<!--DelEnd-->
758
759**处理步骤**
760
761确认appCloneIndex的约束条件是否满足。
762
763## 16000074 返回结果时requestCode对应的调用方不存在
764
765**错误信息**
766
767The caller does not exist.
768
769**错误描述**
770
771通过backTocallerAbilityResult接口向调用方返回结果时,如果根据传入的requestCode无法找到调用方,返回该错误码。
772
773**可能原因**
774
7751. requestCode不是通过want中的CALLER_REQUEST_CODE字段获取的。
776
7772. requestCode对应的调用方已经被销毁或结果已经返回。
778
779**处理步骤**
780
7811. 确认requestCode是否是通过want中的CALLER_REQUEST_CODE获取的。
782
7832. 确认调用方是否被销毁或结果已经返回。
784
785## 16000075 不支持返回结果时拉起调用方
786
787**错误信息**
788
789Not support back to caller.
790
791**错误描述**
792
793不支持通过backToCallerAbilityWithResult接口返回到调用方时,返回该错误码。
794
795**可能原因**
796
797当前应用未进行linkFeature配置或未通过系统审核。
798
799**处理步骤**
800
8011. 确认当前应用已在module.json5文件中配置linkFeature字段。
8022. 确认当前应用声明的linkFeature取值正确,linkFeature描述的功能与应用链接对应的实际功能一致,且应用通过系统审核。
803
804## 16000076 指定的APP_INSTANCE_KEY不存在
805
806**错误信息**
807
808The APP_INSTANCE_KEY is invalid.
809
810**错误描述**
811
812指定的[APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)不存在时,返回该错误码。
813
814**可能原因**
815
816应用的实例中不存在该[APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)指定的实例。
817
818**处理步骤**
819
820确保传入的[APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)是一个有效值。
821
822## 16000077 应用的实例数量已达到上限
823
824**错误信息**
825
826The number of app instances reaches the limit.
827
828**错误描述**
829
830当应用的实例数量达到上限后,继续创建应用实例,返回该错误码。
831
832**可能原因**
833
834创建应用实例前未判断应用实例数量是否已达到应用自己设置的上限值。
835
836**处理步骤**
837
838调整设置的应用实例上限,或者删除已有应用实例后,才能继续创建新的应用实例。
839
840## 16000078 不支持应用多实例
841
842**错误信息**
843
844The multi-instance is not supported.
845
846**错误描述**
847
848应用不支持多实例。
849
850**可能原因**
851
8521. 目标应用未配置多实例。
8532. 当前设备类型不支持多实例。
854
855**处理步骤**
856
8571. 对目标应用配置多实例。
8582. 在2in1设备上调用该方法。
859
860## 16000079 不支持指定APP_INSTANCE_KEY
861
862**错误信息**
863
864The APP_INSTANCE_KEY cannot be specified.
865
866**错误描述**
867
868[APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)和[CREATE_APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)不支持同时指定。当指定[CREATE_APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)的同时指定[APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params),返回该错误码。
869
870**可能原因**
871
872参数传入过多。
873
874**处理步骤**
875
876参数[APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)和[CREATE_APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)只支持二选一。
877
878## 16000080 不支持创建新实例
879
880**错误信息**
881
882Creating an instance is not supported.
883
884**错误描述**
885
886只允许应用使用[CREATE_APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)创建自己的实例,不允许应用间启动时为其他应用创建实例。否则,返回该错误码。
887
888**可能原因**
889
890参数使用场景有误。
891
892**处理步骤**
893
894删除参数[CREATE_APP_INSTANCE_KEY](js-apis-app-ability-wantConstant.md#params)。
895
896## 16000081 获取目标应用信息失败
897
898**错误信息**
899
900Get target application info failed.
901
902**错误描述**
903
904调用<!--Del-->[<!--DelEnd-->URI授权相关接口<!--Del-->](js-apis-uripermissionmanager-sys.md)<!--DelEnd-->时,无法根据应用包名和分身索引获取到目标应用的相关信息。
905
906**可能原因**
907
9081. 没有安装目标应用。
9092. 分身索引超出允许的范围。
9103. 目标应用没有该索引的分身。
911
912**处理步骤**
913
9141. 检查目标应用是否已经安装。
9152. 检查分身应用索引是否在允许范围内。
9163. 检查目标应用是否创建了该索引对应的分身应用。
917
918## 16000082 单实例模式下的UIAbility未完成启动
919
920**错误信息**
921
922The UIAbility is being started.
923
924**错误描述**
925
926如果UIAbility启动模式为“singleton”,在UIAbility启动完成之前不能再次调用启动接口,否则将返回该错误码。
927
928**可能原因**
929
930该UIAbility为singleton模式,正在启动过程中。
931
932**处理步骤**
933
934确保该UIAbility启动完成,再执行新的启动任务。
935
936## 16000083 不允许该类型ExtensionAbility启动指定Ability
937
938**错误信息**
939
940The extension can not start the ability due to extension control.
941
942**错误描述**
943
944不同类型ExtensionAbility所需要的能力不同。系统不允许该类型ExtensionAbility启动指定Ability。
945
946**可能原因**
947
948当前类型ExtensionAbility受系统管控,不允许该类型Extension启动指定Ability。
949
950**处理步骤**
951
952查看对应类型ExtensionAbility的使用约束限制,确保接口使用符合约束限制。
953
954## 16000084 只允许DelegatorAbility单次调用
955
956**错误信息**
957
958Only allow DelegatorAbility to call the method once.
959
960**错误描述**
961
962系统只允许DelegatorAbility调用该接口一次。
963
964**可能原因**
965
9661. 调用方不是DelegatorAbility。
9672. 调用方是DelegatorAbility,但是重复调用接口。
968
969**处理步骤**
970
9711. 检查调用方是否DelegatorAbility。
9722. 检查是否重复调用。
973
974## 16000085 元能力与窗口的交互流程发生错误
975
976**错误信息**
977
978The interaction process between Ability and Window encountered an error.
979
980**错误描述**
981
982元能力与窗口的交互流程发生错误。
983
984**可能原因**
985
986窗口业务流程出现异常。
987
988**处理步骤**
989
990系统错误,尝试重新调用。
991
992## 16000100 监听Ability生命周期变化的AbilityMonitor方法执行失败
993
994**错误信息**
995
996 - Calling AddAbilityMonitor failed.
997
998 - Calling AddAbilityMonitorSync failed.
999
1000 - Calling RemoveAbilityMonitor failed.
1001
1002 - Calling RemoveAbilityMonitorSync failed.
1003
1004 - Calling WaitAbilityMonitor failed.
1005
1006 - Calling GetCurrentTopAbility failed.
1007
1008 - Calling DoAbilityForeground failed.
1009
1010 - Calling DoAbilityBackground failed.
1011
1012 - Calling FinishTest failed.
1013
1014 - Calling AddAbilityStageMonitor failed.
1015
1016 - Calling AddAbilityStageMonitorSync failed.
1017
1018 - Calling RemoveAbilityStageMonitor failed.
1019
1020 - Calling RemoveAbilityStageMonitorSync failed.
1021
1022 - Calling WaitAbilityStageMonitor failed.
1023
1024**错误描述**
1025
1026当监听指定Ability的生命周期变化的AbilityMonitor方法执行失败时,返回该错误码。
1027
1028**可能原因**
1029
1030创建AbilityDelegatorRegistry实例执行失败。
1031
1032**处理步骤**
1033
1034检查是否成功创建了AbilityDelegatorRegistry实例。
1035
1036## 16000101 执行shell命令失败
1037
1038**错误信息**
1039
1040Failed to run the shell command.
1041
1042**错误描述**
1043
1044当命令不是有效的shell命令时,方法将返回该错误码。
1045
1046**可能原因**
1047
1048命令不是有效的shell命令。
1049
1050**处理步骤**
1051
1052检查命令是否为有效的shell命令。
1053
1054## 16000151 无效wantAgent对象
1055
1056**错误信息**
1057
1058Invalid wantAgent object.
1059
1060**错误描述**
1061
1062当传入接口的wantAgent对象无效时,方法将返回该错误码。
1063
1064**可能原因**
1065
10661. 传入接口的wantAgent对象无效。
10672. 三方应用设置其他应用的Ability。
10683. 其它内部通信错误。
1069
1070**处理步骤**
1071
10721. 检查传入接口的wantAgent对象是否存在。
10732. 检查调用方是否为三方应用。不支持三方应用设置其他应用的Ability。
1074
1075## 16000152 未找到wantAgent对象
1076
1077**错误信息**
1078
1079The wantAgent object does not exist.
1080
1081**错误描述**
1082
1083当传入接口的wantAgent对象不存在时,方法将返回该错误码。
1084
1085**可能原因**
1086
1087传入接口的wantAgent对象不存在。
1088
1089**处理步骤**
1090
1091检查传入接口的wantAgent对象是否合法。
1092
1093## 16000153 wangAgent对象已取消
1094
1095**错误信息**
1096
1097The wantAgent object has been canceled.
1098
1099**错误描述**
1100
1101当传入接口的wangAgent对象已取消时,方法将返回该错误码。
1102
1103**可能原因**
1104
1105传入接口的触发的wantAgent已取消。
1106
1107**处理步骤**
1108
1109检查触发的wantAgent对象是否已取消。
1110
1111## 16100001 指定Uri的Ability不存在
1112
1113**错误信息**
1114
1115The ability with the specified URI does not exist.
1116
1117**错误描述**
1118
1119当指定Uri的Ability不存在时,方法将返回该错误码。
1120
1121**可能原因**
1122
1123所查询的Ability不存在。
1124
1125**处理步骤**
1126
1127确认查询的Ability是否存在。
1128
1129## 16100002 接口调用Ability类型错误
1130
1131**错误信息**
1132
1133Incorrect ability type.
1134
1135**错误描述**
1136
1137当接口调用Ability类型错误时,方法将返回该错误码。
1138
1139**可能原因**
1140
1141接口调用所在的Ability类型不支持该接口调用。
1142
1143**处理步骤**
1144
11451. 检查包名对应的Ability是否正确。
11462. 根据Ability类型调用不同接口。
1147
1148## 16200001 通用组件客户端(Caller)已回收
1149
1150**错误信息**
1151
1152The caller has been released.
1153
1154**错误描述**
1155
1156当通用组件客户端(Caller)已回收时,方法将返回该错误码。
1157
1158**可能原因**
1159
1160通用组件客户端(Caller)已回收。
1161
1162**处理步骤**
1163
11641. 请重新注册有效通用组件客户端调用接口。
11652. 检查调用context.startAbility时,context对应的ability是否还在运行。若该ability已被析构,会抛出该错误码。
11663. 若存在连续调用startAbility和terminateSelf的情况,请确认收到startAbility成功或失败的回调后,再调用terminateSelf。
1167
1168## 16200002 通用组件服务端(Callee)无效
1169
1170**错误信息**
1171
1172The callee does not exist.
1173
1174**错误描述**
1175
1176当通用组件服务端(Callee)无效时,方法将返回该错误码。
1177
1178**可能原因**
1179
1180通用组件服务端(Callee)不存在。
1181
1182**处理步骤**
1183
1184请检查通用组件服务端是否存在。
1185
1186## 16200003 回收失败
1187
1188**错误信息**
1189
1190Release error. The caller does not call any callee.
1191
1192**错误描述**
1193
1194当回收失败时,方法将返回该错误码。
1195
1196**可能原因**
1197
1198通用组件客户端(Caller)对象未注册通用组件服务端(Callee)。
1199
1200**处理步骤**
1201
1202请检查是否已注册通用组件服务端。
1203
1204## 16200004 方法已注册
1205
1206**错误信息**
1207
1208The method has been registered.
1209
1210**错误描述**
1211
1212当方法已注册时,方法将返回该错误码。
1213
1214**可能原因**
1215
1216方法已在通用组件服务端注册过。
1217
1218**处理步骤**
1219
1220请检查是否已注册该方法。
1221
1222## 16200005 方法未注册
1223
1224**错误信息**
1225
1226The method has not been registered.
1227
1228**错误描述**
1229
1230当方法未注册时,方法将返回该错误码。
1231
1232**可能原因**
1233
1234方法未在通用组件服务端注册。
1235
1236**处理步骤**
1237
1238请检查是否未注册该方法。
1239
1240## 16200006 没有权限设置常驻进程使能状态
1241
1242**错误信息**
1243
1244The caller application can only set the resident status of the configured process.
1245
1246**错误描述**
1247
1248当调用者没有权限设置常驻进程使能状态时返回。
1249
1250**可能原因**
1251
1252调用者没有常驻进程使能配置权限。
1253
1254**处理步骤**
1255
1256接口调用时从数据库查询调用者的常驻进程使能配置权限。
1257
1258## 16300001 指定的任务不存在
1259
1260**错误信息**
1261
1262Mission not found.
1263
1264**错误描述**
1265
1266当指定的任务不存在时,方法将返回该错误码。
1267
1268**可能原因**
1269
1270操作的目标任务不存在。
1271
1272**处理步骤**
1273
1274确认操作的任务是否存在。
1275
1276## 16300002 指定的任务监听器不存在
1277
1278**错误信息**
1279
1280The specified mission listener does not exist.
1281
1282**错误描述**
1283
1284当指定的任务监听器不存在时,方法将返回该错误码。
1285
1286**可能原因**
1287
1288操作的目标任务监听器不存在。
1289
1290**处理步骤**
1291
1292确认操作的任务监听器是否存在。
1293
1294## 16300003 目标应用程序不是自身应用程序
1295
1296**错误信息**
1297
1298The target application is not the current application.
1299
1300**错误描述**
1301
1302当被拉起的应用程序不是自身应用程序时,方法将返回该错误码。
1303
1304**可能原因**
1305
1306被拉起的应用和发起调用的应用不是同一个应用程序。
1307
1308**处理步骤**
1309
1310确认被拉起的应用程序是否为自身应用程序。
1311
1312## 18500001 指定的包名无效
1313
1314**错误信息**
1315
1316The bundle does not exist or no patch has been applied.
1317
1318**错误描述**
1319
1320当指定的包名无效时,方法将返回该错误码。
1321
1322**可能原因**
1323
1324待查询的bundle不存在或未安装。
1325
1326**处理步骤**
1327
1328确认查询的应用是否已安装。
1329
1330## 18500002 指定的补丁包无效
1331
1332**错误信息**
1333
1334Invalid patch package.
1335
1336**错误描述**
1337
1338当指定的补丁包无效,补丁包不存在或不可访问时,方法将返回该错误码。
1339
1340**可能原因**
1341
1342待安装的补丁包文件不存在或不可以访问。
1343
1344**处理步骤**
1345
13461. 请检查传递的补丁包文件路径是否有效。
13472. 请检查是否有权限访问此补丁包文件。
1348
1349## 18500003 补丁包部署失败
1350
1351**错误信息**
1352
1353Failed to deploy the patch.
1354
1355**错误描述**
1356
1357当补丁包部署失败时,方法将返回该错误码。
1358
1359**可能原因**
1360
13611. patch.json中type只能为patch或者hotreload,否则部署失败。
13622. 若对应bundleName的hap包未安装,部署失败。
13633. bundleName、versionCode必须和已安装的hap应用相同,如果为patch类型,还需确保versionName相同,否则部署失败。
13644. 如果已经部署过补丁包,新部署的补丁包的versionCode必须大于之前补丁包的versionCode,否则部署失败。
13655. 对于patch类型的补丁会校验签名信息,使用的签名证书需要和应用相同,签名不一致,部署失败。
13666. 在部署patch类型的补丁包时,如果是debug版本,先判断是否有在使用的补丁包,如果在使用的补丁包为hotreload类型,则部署失败。
13677. 在部署hotreload类型的补丁包时,如果是debug版本,先判断是否有在使用的补丁包,如果在使用的补丁包为patch类型,则部署失败;如果是release版本,则部署失败。
1368
1369**处理步骤**
1370
1371请检查补丁包是否符合规则。
1372
1373## 18500004 补丁包使能失败
1374
1375**错误信息**
1376
1377Failed to enable the patch package.
1378
1379**错误描述**
1380
1381当补丁包使能失败时,方法将返回该错误码。
1382
1383**可能原因**
1384
1385使能补丁时补丁包状态不正确。
1386
1387**处理步骤**
1388
1389请检查补丁包状态。
1390
1391## 18500005 补丁包删除失败
1392
1393**错误信息**
1394
1395Failed to remove the patch package.
1396
1397**错误描述**
1398
1399当补丁包删除失败时,方法将返回该错误码。
1400
1401**可能原因**
1402
1403删除旧补丁时补丁包状态不正确。
1404
1405**处理步骤**
1406
1407请检查补丁包状态。
1408
1409## 18500006 加载补丁失败
1410
1411**错误信息**
1412
1413Failed to load the patch.
1414
1415**错误描述**
1416
1417当加载补丁失败时,方法将返回该错误码。
1418
1419**可能原因**
1420
1421方舟引擎加载补丁失败。
1422
1423**处理步骤**
1424
1425请检查补丁包是否正确。
1426
1427## 18500007 卸载旧补丁失败
1428
1429**错误信息**
1430
1431Failed to unload the patch.
1432
1433**错误描述**
1434
1435当方舟引擎卸载旧补丁失败时,方法将返回该错误码。
1436
1437**可能原因**
1438
1439方舟引擎卸载补丁失败。
1440
1441**处理步骤**
1442
1443请检查补丁包是否正确。
1444
1445## 18500008 快速修复内部错误
1446
1447**错误信息**
1448
1449Internal error.
1450
1451**错误描述**
1452
1453当内存申请、多线程处理异常等内部处理错误时,方法将返回该错误码。
1454
1455**可能原因**
1456
1457内存申请、多线程处理等内核通用错误。
1458
1459**处理步骤**
1460
1461确认系统内存是否足够。
1462
1463## 18500009 该应用当前有正在处理的快速修复任务
1464
1465**错误信息**
1466
1467The application has an ongoing quick fix task.
1468
1469**错误描述**
1470
1471该应用当前有正在处理的快速修复任务时,方法将返回该错误码。
1472
1473**可能原因**
1474
1475指定要撤销快速修复的应用,有正在处理的快速修复任务。
1476
1477**处理步骤**
1478
1479等待快速修复任务处理完成。
1480
1481## 16300004 指定的observer不存在
1482
1483**错误信息**
1484
1485observer not found.
1486
1487**错误描述**
1488
1489当监听器不存在时,方法将返回该错误码。
1490
1491**可能原因**
1492
1493当前监听器不存在或者已注销。
1494
1495**处理步骤**
1496
1497请检查是否有重复注销监听器。
1498
1499## 16300005 指定的包信息不存在
1500
1501**错误信息**
1502
1503The target bundle does not exist.
1504
1505**错误描述**
1506
1507预加载应用的包信息不存在时,方法将返回该错误码。
1508
1509**可能原因**
1510
1511预加载的bundleName、userId或appIndex错误,导致查询不到相关包信息。
1512
1513**处理步骤**
1514
1515检查传入的bundleName、userId和appIndex参数是否正确。
1516
1517## 16300008 指定的包不存在主UIAbility
1518
1519**错误信息**
1520
1521The target bundle has no main uiability.
1522
1523**错误描述**
1524
1525应用不存在主UIAbility。
1526
1527**可能原因**
1528
1529应用的mainElement不是UIAbility。
1530
1531**处理步骤**
1532
1533检查应用module.json中的mainElement对应的ability是否是UIAbility。
1534
1535## 16300009 指定的包不存在状态栏
1536
1537**错误信息**
1538
1539The target bundle has no status-bar ability.
1540
1541**错误描述**
1542
1543应用不存在状态栏。
1544
1545**可能原因**
1546
1547应用不存在状态栏。
1548
1549**处理步骤**
1550
1551检查应用是否有状态栏。
1552
1553## 16300010 指定的应用在运行中但没有绑定状态栏
1554
1555**错误信息**
1556
1557The target application is not attached to status bar.
1558
1559**错误描述**
1560
1561应用运行后没有绑定状态栏。
1562
1563**可能原因**
1564
1565应用有状态栏,但在运行过程中没有绑定状态栏。
1566
1567**处理步骤**
1568
1569检查应用是否绑定状态栏。
1570
1571## 29600001 图片编辑内部错误
1572
1573**错误信息**
1574
1575Internal error.
1576
1577**错误描述**
1578
1579当图片保存时发生内存申请、多线程处理异常等内部错误时,方法将返回该错误码。
1580
1581**可能原因**
1582
1583内存申请、多线程处理等内核通用错误。具体原因可能包括:内部对象为空、处理超时等等。
1584
1585**处理步骤**
1586
15871. 确认系统内存是否足够,设备使用的系统版本是否存在异常。
15882. 尝试重启设备。
1589
1590## 29600002 图片编辑内部错误
1591
1592**错误信息**
1593
1594Image input error.
1595
1596**错误描述**
1597
1598当图片uri不存在或无法解析图片时,方法将返回该错误码。
1599
1600**可能原因**
1601
1602uri不存在或uri非图片类型文件。
1603
1604**处理步骤**
1605
1606检查文件是否存在以及文件类型是否为图片。
1607
1608## 29600002 图片大小过大
1609
1610**错误信息**
1611
1612Image too big.
1613
1614**错误描述**
1615
1616入参所传入的图片大小过大。
1617
1618**可能原因**
1619
1620当入参图片大小超过50M时,方法将返回该错误码。
1621
1622**处理步骤**
1623
16241. 尝试将图片编辑后大小控制在50M以内。
16252. 对图片大小进行校验。
1626
1627## 16300007 指定的原子化服务的下载安装任务信息不存在
1628
1629**错误信息**
1630
1631The target free install task does not exist.
1632
1633**错误描述**
1634
1635为原子化服务窗口打开窗口时,指定的原子化服务的下载安装任务不存在时,方法将返回该错误码。
1636
1637**可能原因**
1638
1639传入的bundleName、moduleName、abilityName或startTime错误,导致查询不到相关原子化服务原子化服务的下载安装任务信息。
1640
1641**处理步骤**
1642
1643检查传入的bundleName、moduleName、abilityName或startTime参数是否正确。
1644
1645## 28800001 启动任务或其依赖项不存在
1646
1647**错误信息**
1648
1649Startup task or its dependency not found.
1650
1651**错误描述**
1652
1653执行启动任务时,如果找不到该启动任务或其依赖的任务,方法将返回该错误码。
1654
1655**可能原因**
1656
1657未正确配置启动任务或其依赖的任务。
1658
1659**处理步骤**
1660
1661检查启动框架配置文件是否正确编写,并确保所有配置的启动任务均已实现。
1662
1663## 28800002 启动任务之间存在循环依赖关系
1664
1665**错误信息**
1666
1667The startup tasks have circular dependencies.
1668
1669**错误描述**
1670
1671在加载启动任务时,如果检测到启动任务之间存在循环依赖,方法将返回该错误码。
1672
1673**可能原因**
1674
1675配置的启动任务之间存在循环依赖关系。
1676
1677**处理步骤**
1678
1679检查启动框架配置文件,确保所有启动任务之间没有循环依赖。
1680
1681## 28800003 运行启动任务时发生错误
1682
1683**错误信息**
1684
1685An error occurred while running the startup tasks.
1686
1687**错误描述**
1688
1689运行启动任务时发生错误,方法将返回该错误码。
1690
1691**可能原因**
1692
1693启动任务的代码逻辑存在错误,或者缺少异常处理。
1694
1695**处理步骤**
1696
1697检查实现的启动任务是否存在逻辑错误,并确保每个启动任务中包含异常处理逻辑。
1698
1699## 28800004 执行启动任务超时
1700
1701**错误信息**
1702
1703Running startup tasks timeout.
1704
1705**错误描述**
1706
1707如果启动任务的执行时间超过设置的超时时间(默认为10000毫秒),方法将返回该错误码。
1708
1709**可能原因**
1710
1711启动任务中包含大量耗时操作,或者设置的超时时间过短。
1712
1713**处理步骤**
1714
1715根据需要调整超时时间。超时时间的设置可参见[设置启动参数](../../application-models/app-startup.md#设置启动参数)。
1716