1# 元能力子系统错误码 2 3> **说明：** 4> 5> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](errorcode-universal.md)。 6 7## 16000001 指定的Ability名称不存在 8 9**错误信息** 10 11Incorrect Ability name. The specified Ability name 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应使用[startServiceExtensionAbility](../apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartserviceextensionability)方法启动或[connectServiceExtensionAbility()](../apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)方法连接。 51 52## 16000003 指定的ID不存在 53 54**错误信息** 55 56Input error. The 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 74Visibility verification failed. 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](../../security/permission-list.md#ohospermissionstart_invisible_ability)权限。 88 89## 16000006 不允许跨用户操作 90 91**错误信息** 92 93Cross-user operations are not allowed. 94 95**错误描述** 96 97当应用跨用户操作时，方法将返回该错误码。 98 99**可能原因** 100 101应用进行了跨用户操作。 102 103**处理步骤** 104 105确认是否进行了跨用户操作。 106 107## 16000007 服务繁忙 108 109**错误信息** 110 111Service busy, please wait and try again. 112 113**错误描述** 114 115当服务繁忙时，方法将返回该错误码。 116 117**可能原因** 118 119服务繁忙。 120 121**处理步骤** 122 123服务繁忙，请稍后重试。 124 125## 16000008 众测应用到期 126 127**错误信息** 128 129Crowdtest App Expired. 130 131**错误描述** 132 133当众测应用到期时，方法将返回该错误码。 134 135**可能原因** 136 137众测应用到期，无法打开。 138 139**处理步骤** 140 141请检查应用是否众测到期，已过有效期的众测应用无法启动。 142 143## 16000009 wukong模式，不允许启动/停止ability 144 145**错误信息** 146 147Ability cannot be started or sotpped in Wukong mode. 148 149**错误描述** 150 151当wukong模式下，启动/停止ability时，方法将返回该错误码。 152 153**可能原因** 154 155wukong模式，不允许启动/停止ability。 156 157**处理步骤** 158 159退出wukong模式后，再尝试启动/停止ability。请勿在wukong模式下启动/停止Ability。 160 161## 16000010 不允许带迁移flag 162 163**错误信息** 164 165The call with the continuation flag is forbidden. 166 167**错误描述** 168 169当调用携带迁移flag时，方法将返回该错误码。 170 171**可能原因** 172 173当前调用不允许携带迁移flag。 174 175**处理步骤** 176 177请检查是否携带迁移flag。 178 179## 16000011 上下文对象不存在 180 181**错误信息** 182 183The context does not exist. 184 185**错误描述** 186 187当上下文对象不存在时，方法将返回该错误码。 188 189**可能原因** 190 191当前上下文对象不存在。 192 193**处理步骤** 194 195请检查上下文对象是否可用。 196 197## 16000012 应用被管控 198 199**错误信息** 200 201The application is controlled. 202 203**错误描述** 204 205当应用受到应用市场管控时，方法将返回该错误码。 206 207**可能原因** 208 209应用疑似存在恶意行为，受到应用市场管控不允许启动。 210 211**处理步骤** 212 213建议卸载该应用。 214 215## 16000013 应用被EDM管控 216 217**错误信息** 218 219The application is controlled by EDM. 220 221**错误描述** 222 223当应用受到企业设备管理[Enterprise Device Manager](../apis/enterpriseDeviceManagement-overview.md)管控时，方法将返回该错误码。 224 225**可能原因** 226 227应用受企业设备管理管控。 228 229**处理步骤** 230 231请联系企业设备管理相关人员。 232 233## 16000017 上一个Ability未启动完成，先缓存在队列中等待后续启动。 234 235**错误信息** 236 237The previous ability is starting, wait start later. 238 239**错误描述** 240 241需要启动的Ability过多，由于系统处理能力有限，会先将请求缓存在队列中，按照顺序依次处理。 242 243**可能原因** 244 245系统并发大。 246 247**处理步骤** 248 249无需处理，等待启动即可。 250 251## 16000050 内部错误 252 253**错误信息** 254 255Internal error. 256 257**错误描述** 258 259当内存申请、多线程处理异常等内部处理错误时，方法将返回该错误码。 260 261**可能原因** 262 263内存申请、多线程处理等内核通用错误。具体原因可能包括：内部对象为空、处理超时、包管理获取应用信息失败、系统服务获取失败、启动的ability实例已达到上限等等。 264 265**处理步骤** 266 2671. 确认系统内存是否足够，设备使用的系统版本是否存在异常。 2682. 检查是否启动了过多的ability。 2693. 尝试重启设备。 270 271## 16000051 网络异常 272 273**错误信息** 274 275Network error. 276 277**错误描述** 278 279当网络异常时，方法将返回该错误码。 280 281**可能原因** 282 283网络不可用。 284 285**处理步骤** 286 287网络异常，请稍后重试，或者重连网络尝试。 288 289## 16000052 不支持免安装 290 291**错误信息** 292 293Installation-free is not supported. 294 295**错误描述** 296 297当前应用不支持免安装时，方法将返回该错误码。 298 299**可能原因** 300 301应用包不满足免安装要求，如包大小超过限制等。 302 303**处理步骤** 304 305请检查应用是否支持免安装。 306 307## 16000053 非顶层应用 308 309**错误信息** 310 311The ability is not on the top of UI. 312 313**错误描述** 314 315当前应用未显示在界面顶层时，方法将返回该错误码。 316 317**可能原因** 318 319用户执行免安装启动时需要确保应用在前台，但应用未显示在界面顶层。 320 321**处理步骤** 322 323请检查当前应用是否显示在界面顶层。 324 325## 16000054 免安装服务繁忙 326 327**错误信息** 328 329Installation-free service is busy, please wait and try again later. 330 331**错误描述** 332 333当免安装服务繁忙时，方法将返回该错误码。 334 335**可能原因** 336 337已有相同免安装任务在执行。 338 339**处理步骤** 340 341免安装服务繁忙，请稍后重试。 342 343## 16000055 免安装超时 344 345**错误信息** 346 347Installation-free time out. 348 349**错误描述** 350 351当免安装超时时，方法将返回该错误码。 352 353**可能原因** 354 355免安装超时。 356 357**处理步骤** 358 359免安装超时，请稍后重试。 360 361## 16000056 不允许免安装其他应用 362 363**错误信息** 364 365Installation-free is not allowed for other applications. 366 367**错误描述** 368 369当免安装其他应用时，方法将返回该错误码。 370 371**可能原因** 372 373不允许免安装其他应用。 374 375**处理步骤** 376 377确认免安装的是正确的应用。 378 379## 16000057 不支持跨设备免安装 380 381**错误信息** 382 383Cross-device installation-free is not supported. 384 385**错误描述** 386 387当持跨设备免安装时，方法将返回该错误码。 388 389**可能原因** 390 391不支持跨设备免安装。 392 393**处理步骤** 394 395确认为非跨设备免安装应用。 396 397## 16000058 指定的URI flag无效 398 399**错误信息** 400 401Invalid URI flag. 402 403**错误描述** 404 405指定的URI flag无效。 406 407**可能原因** 408 409传入的参数有误。 410 411**处理步骤** 412 413确认传入的参数属于Uri flag。 414 415## 16000059 指定的URI类型无效。 416 417**错误信息** 418 419Invalid URI type. 420 421**错误描述** 422 423指定的URI类型无效。 424 425**可能原因** 426 427传入的参数有误，目前URI授权管理仅支持file类型URI。 428 429**处理步骤** 430 431确认传入的参数属于支持的URI类型。 432 433## 16000060 不支持沙箱应用授权URI 434 435**错误信息** 436 437Sandbox application can not grant URI permission. 438 439**错误描述** 440 441当沙箱应用授权URI时，方法将返回该错误码。 442 443**可能原因** 444 445不支持沙箱应用授权URI 446 447**处理步骤** 448 449确认为非沙箱应用。 450 451## 16000101 执行shell命令失败 452 453**错误信息** 454 455Failed to run the shell command. 456 457**错误描述** 458 459当命令不是有效的shell命令时，方法将返回该错误码。 460 461**可能原因** 462 463命令不是有效的shell命令。 464 465**处理步骤** 466 467检查命令是否为有效的shell命令。 468 469## 16000151 无效wantAgent对象 470 471**错误信息** 472 473Invalid wantAgent object. 474 475**错误描述** 476 477当传入接口的wantAgent对象无效时，方法将返回该错误码。 478 479**可能原因** 480 481传入接口的wantAgent对象无效。 482 483**处理步骤** 484 485检查传入接口的wantAgent对象。 486 487## 16000152 未找到wantAgent对象 488 489**错误信息** 490 491the wantAgent object does not exist. 492 493**错误描述** 494 495当传入接口的wantAgent对象不存在时，方法将返回该错误码。 496 497**可能原因** 498 499传入接口的wantAgent对象不存在。 500 501**处理步骤** 502 503检查传入接口的wantAgent对象是否合法。 504 505## 16000153 wangAgent对象已取消 506 507**错误信息** 508 509wangAgent object has been canceled. 510 511**错误描述** 512 513当传入接口的wangAgent对象已取消时，方法将返回该错误码。 514 515**可能原因** 516 517传入接口的触发的wantAgent已取消。 518 519**处理步骤** 520 521检查触发的wantAgent对象是否已取消。 522 523## 16100001 指定Uri的Ability不存在 524 525**错误信息** 526 527The ability with the specified URI does not exist. 528 529**错误描述** 530 531当指定Uri的Ability不存在时，方法将返回该错误码。 532 533**可能原因** 534 535所查询的Ability不存在。 536 537**处理步骤** 538 539确认查询的Ability是否存在。 540 541## 16100002 接口调用Ability类型错误 542 543**错误信息** 544 545Incorrect ability type. 546 547**错误描述** 548 549当接口调用Ability类型错误时，方法将返回该错误码。 550 551**可能原因** 552 553接口调用所在的Ability类型不支持该接口调用。 554 555**处理步骤** 556 5571. 检查包名对应的Ability是否正确。 5582. 根据Ability类型调用不同接口。 559 560## 16200001 通用组件客户端(Caller)已回收 561 562**错误信息** 563 564The caller has been released. 565 566**错误描述** 567 568当通用组件客户端(Caller)已回收时，方法将返回该错误码。 569 570**可能原因** 571 572通用组件客户端(Caller)已回收。 573 574**处理步骤** 575 5761. 请重新注册有效通用组件客户端调用接口。 5772. 检查调用context.startAbility时，context对应的ability是否还在运行。若该ability已被析构，会抛出该错误码。 5783. 若存在连续调用startAbility和terminateSelf的情况，请确认收到startAbility成功或失败的回调后，再调用terminateSelf。 579 580## 16200002 通用组件服务端(Callee)无效 581 582**错误信息** 583 584The callee does not exist. 585 586**错误描述** 587 588当通用组件服务端(Callee)无效时，方法将返回该错误码。 589 590**可能原因** 591 592通用组件服务端(Callee)不存在。 593 594**处理步骤** 595 596请检查通用组件服务端是否存在。 597 598## 16200003 回收失败 599 600**错误信息** 601 602Release error. The caller does not call any callee. 603 604**错误描述** 605 606当回收失败时，方法将返回该错误码。 607 608**可能原因** 609 610通用组件客户端(Caller)对象未注册通用组件服务端(Callee)。 611 612**处理步骤** 613 614请检查是否已注册通用组件服务端。 615 616## 16200004 方法已注册 617 618**错误信息** 619 620The method has registered. 621 622**错误描述** 623 624当方法已注册时，方法将返回该错误码。 625 626**可能原因** 627 628方法已在通用组件服务端注册过。 629 630**处理步骤** 631 632请检查是否已注册该方法。 633 634## 16200005 方法未注册 635 636**错误信息** 637 638The method is not registered. 639 640**错误描述** 641 642当方法未注册时，方法将返回该错误码。 643 644**可能原因** 645 646方法未在通用组件服务端注册。 647 648**处理步骤** 649 650请检查是否未注册该方法。 651 652## 16300001 指定的任务不存在 653 654**错误信息** 655 656The specified mission id does not exist. 657 658**错误描述** 659 660当指定的任务不存在时，方法将返回该错误码。 661 662**可能原因** 663 664操作的目标任务不存在。 665 666**处理步骤** 667 668确认操作的任务是否存在。 669 670## 16300002 指定的任务监听器不存在 671 672**错误信息** 673 674The specified mission listener does not exist. 675 676**错误描述** 677 678当指定的任务监听器不存在时，方法将返回该错误码。 679 680**可能原因** 681 682操作的目标任务监听器不存在。 683 684**处理步骤** 685 686确认操作的任务监听器是否存在。 687 688## 16300003 目标应用程序不是自身应用程序 689 690**错误信息** 691 692The target application is not self application. 693 694**错误描述** 695 696当被拉起的应用程序不是自身应用程序时，方法将返回该错误码。 697 698**可能原因** 699 700被拉起的应用和发起调用的应用不是同一个应用程序。 701 702**处理步骤** 703 704确认被拉起的应用程序是否为自身应用程序。 705 706## 18500001 指定的包名无效 707 708**错误信息** 709 710Invalid bundle name. 711 712**错误描述** 713 714当指定的包名无效时，方法将返回该错误码。 715 716**可能原因** 717 718待查询的bundle不存在或未安装。 719 720**处理步骤** 721 722确认查询的应用是否已安装。 723 724## 18500002 指定的补丁包无效 725 726**错误信息** 727 728Invalid patch package. 729 730**错误描述** 731 732当指定的补丁包无效，补丁包不存在或不可访问时，方法将返回该错误码。 733 734**可能原因** 735 736待安装的补丁包文件不存在或不可以访问。 737 738**处理步骤** 739 7401. 请检查传递的补丁包文件路径是否有效。 7412. 请检查是否有权限访问此补丁包文件。 742 743## 18500003 补丁包部署失败 744 745**错误信息** 746 747Failed to deploy the patch. 748 749**错误描述** 750 751当补丁包部署失败时，方法将返回该错误码。 752 753**可能原因** 754 7551. patch.json中type只能为patch或者hotreload，否则部署失败。 7562. 若对应bundleName的hap包未安装，部署失败。 7573. bundleName、versionCode必须和已安装的hap应用相同，如果为patch类型，还需确保versionName相同，否则部署失败。 7584. 如果已经部署过补丁包，新部署的补丁包的versionCode必须大于之前补丁包的versionCode，否则部署失败。 7595. 对于patch类型的补丁会校验签名信息，使用的签名证书需要和应用相同，签名不一致，部署失败。 7606. 在部署patch类型的补丁包时，如果是debug版本，先判断是否有在使用的补丁包，如果在使用的补丁包为hotreload类型，则部署失败。 7617. 在部署hotreload类型的补丁包时，如果是debug版本，先判断是否有在使用的补丁包，如果在使用的补丁包为patch类型，则部署失败；如果是release版本，则部署失败。 762 763**处理步骤** 764 765请检查补丁包是否符合规则。 766 767## 18500004 补丁包使能失败 768 769**错误信息** 770 771Failed to enable the patch package. 772 773**错误描述** 774 775当补丁包使能失败时，方法将返回该错误码。 776 777**可能原因** 778 779使能补丁时补丁包状态不正确。 780 781**处理步骤** 782 783请检查补丁包状态。 784 785## 18500005 补丁包删除失败 786 787**错误信息** 788 789Failed to enable the patch package. 790 791**错误描述** 792 793当补丁包删除失败时，方法将返回该错误码。 794 795**可能原因** 796 797删除旧补丁时补丁包状态不正确。 798 799**处理步骤** 800 801请检查补丁包状态。 802 803## 18500006 加载补丁失败 804 805**错误信息** 806 807Failed to load the patch. 808 809**错误描述** 810 811当加载补丁失败时，方法将返回该错误码。 812 813**可能原因** 814 815方舟引擎加载补丁失败。 816 817**处理步骤** 818 819请检查补丁包是否正确。 820 821## 18500007 卸载旧补丁失败 822 823**错误信息** 824 825Failed to unload the patch. 826 827**错误描述** 828 829当方舟引擎卸载旧补丁失败时，方法将返回该错误码。 830 831**可能原因** 832 833方舟引擎卸载补丁失败。 834 835**处理步骤** 836 837请检查补丁包是否正确。 838 839## 18500008 快速修复内部错误 840 841**错误信息** 842 843Internal error. 844 845**错误描述** 846 847当内存申请、多线程处理异常等内部处理错误时，方法将返回该错误码。 848 849**可能原因** 850 851内存申请、多线程处理等内核通用错误。 852 853**处理步骤** 854 855确认系统内存是否足够。 856 857## 18500009 该应用当前有正在处理的快速修复任务 858 859**错误信息** 860 861The application has a apply quick fix task that is being processed. 862 863**错误描述** 864 865该应用当前有正在处理的快速修复任务时，方法将返回该错误码。 866 867**可能原因** 868 869指定要撤销快速修复的应用，有正在处理的快速修复任务。 870 871**处理步骤** 872 873等待快速修复任务处理完成。