# ArkTS API错误码 > phone | 2in1 | tablet | wearable > 说明 > > 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。 ## 1002600001 系统内部错误 **错误信息** System internal error. **错误描述** 当发生系统内部错误时，将返回该错误码。 **可能原因** 其他未知错误。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600002 应用连接地图服务失败 **错误信息** Failed to connect to the Map Kit server. **错误描述** 应用连接地图服务失败。 **可能原因** 1. 设备网络存在问题。 2. 使用自动签名时，未连接上地图服务。 **处理步骤** 1. 检查设备网络状态。 2. 清除旧证书配置后，重新自动签名，并配置client_id和证书指纹；从HarmonyOS 5.0.2(14)版本开始，可参考[开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-config-agc)进行配置。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d4/v3/X0PHNjdeTgGog-htFgUyLA/zh-cn_image_0000002778935117.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=CED1118B35410B020643740F401F05C14C39DF6567F11D113D03804AFCA5C1C3) ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c9/v3/32Xs4CT9RxC0C7IGm_5dRg/zh-cn_image_0000002749336032.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=350432FED8B9A0ED91171B707BE9EA493AE66897D3767601D194F50A242D5EC7) 3. 如未解决，请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600003 应用身份校验失败 **错误信息** App authentication failed. **错误描述** 应用身份校验失败。 **可能原因** 1. 项目module.json5文件中配置的client_id与AGC上不一致。 2. AGC上公钥指纹为空或错误。 3. 设备网络状态差，身份认证超时。 4. 公钥指纹配置后还未生效。 5. 配置profile文件之前，未开通地图服务开关。 6. 配置自动签名时，重复配置导致AGC上调试证书和本地使用证书不匹配。 **处理步骤** 1. 检查module.json5文件中配置的client_id与AGC上是否一致。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d5/v3/Oggn5c7IQu-AS4QI6kqSsA/zh-cn_image_0000002749495916.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=5BF5CAB89D4ADFED8CEB32514F9F729E1FA410756FA9B4279EA5AD75AD1800A0) ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/48/v3/AGUC-4_iTuafg4h7eNMKmg/zh-cn_image_0000002779094973.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=328241B44E0CED50F506BEFB58C4F1F8FEEC79BE3FD08C4222852D1490D39571) 2. 重新生成公钥指纹（[自动生成签名证书指纹](https://developer.huawei.com/consumer/cn/doc/app/agc-help-signature-info-0000001628566748#section958212134217)/[手动生成签名证书指纹](https://developer.huawei.com/consumer/cn/doc/app/agc-help-signature-info-0000001628566748#section2049119231438)），然后在AGC上[配置公钥指纹](https://developer.huawei.com/consumer/cn/doc/app/agc-help-cert-fingerprint-0000002278002933)。 3. 检查设备网络状态后重新尝试。 4. 将设备的系统时间往后调整1天。 5. 请根据[开通地图服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-config-agc#开通地图服务)，先打开地图服务开关，然后重新[申请调试Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-debugprofile-0000001914423102)，并[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing-manual)。 6. 自动签名证书不匹配有两种解决方案： 方案一：将本地已生成的csr签名，通过AGC重新生成新的调试证书，然后通过新的调试证书选择生成新的指纹证书。 自动签名默认已生成的csr签名在如下图路径下，马赛克部分为用户名。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9c/v3/HUBFFxTrTEuAMQ4t0rAmkw/zh-cn_image_0000002778935119.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=82F349DD6790EDA4DD97BA4F017129542132EBB858F7E087529D37198D42267F) 在AGC上新增证书，将上述所选csr文件选中并生成新的调试证书。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/83/v3/CyU2-NLiQ-SVNImRLmOWGQ/zh-cn_image_0000002749336034.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=241E5145680736E25B3644A7F6292EB0CEF38E7E9F68BA4BCDE7CED872C7B983) 然后添加公钥指纹，选中刚才自己生成调试证书即可。（需注意，配置完成后由于鉴权缓存，可能还是无法马上显示地图，须清除缓存或者将设备的系统时间往后调整1天，才能立刻显示地图。） ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/10/v3/CJdJowwfSJS5qS4nKp120A/zh-cn_image_0000002749495920.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=A871165EE85F7E1B3DDBC438C4D2CEA7BE7C4A3509A559D323EEF75D58686DF5) 方案二：将本地配置自动签名证书和AGC上调试证书全部删除，重新生成新的自动签名，调试证书会自动生成，并用新的调试证书生成公钥指纹。 将build-profile.json5文件下signingConfigs参数删除。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4/v3/hNEO5A72RKaKj3-PAVn8rQ/zh-cn_image_0000002779094975.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=4A82127444F3491F2B87627AA7A84F753A02F878B436755252033683C05DA870) 将config文件夹下所有内容删除。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a8/v3/0O0K8alwRm2v9ZhhDnjBog/zh-cn_image_0000002778935121.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=D92DCC229A65DEA77D705B1852898605DA22BB1C20D4E271903563053DA6467C) 将AGC上自动签名生成的调试证书删除。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2e/v3/NBjhWawORMWqVIU3RwIyhg/zh-cn_image_0000002749336036.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=B096639CF58050E28171A90CC27C70593D3E39C2055B11CCEC2A2F6D9DD278FE) 将旧证书删除后生成新的自动签名，调试证书会被同步创建，然后用新生成的调试证书生成新的指纹即可。（需注意，配置完成后由于鉴权缓存，可能还是无法马上显示地图，须清除缓存或者将设备的系统时间往后调整1天，才能立刻显示地图。） ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/05/v3/dtj-MVhTSby_njwgUCk_Mg/zh-cn_image_0000002749495922.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=825E54E818842E953A0D1CA9CA9D833FF3603994721E5FAC2188E79007BE67FB) 7. 如未解决，请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600004 应用没有开通地图服务权限 **错误信息** The Map permission is not enabled. **错误描述** 应用没有开通地图服务权限。 **可能原因** 1. 没有开通地图服务权限。 2. client_id未配置。 **处理步骤** 1. [开通地图服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-config-agc#开通地图服务)。 2. 配置client_id。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8a/v3/B5_ZKg8ZSHGA3YUW9JLing/zh-cn_image_0000002779094977.png?HW-CC-KV=V1&HW-CC-Date=20260929T121718Z&HW-CC-Expire=31536000000&HW-CC-Sign=5E81DE086E9D6D0FC1996EC79022DDF50BF3208530C8E5A547CF051F4E34CB53) 3. 如未解决，请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600005 网络不可用 **错误信息** The network is unavailable. **错误描述** 网络不可用。 **可能原因** 网络不可用。 **处理步骤** 检查网络后尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600006 API调用量超出配额 **错误信息** The API call times exceed the quota. **错误描述** API调用量超出配额。 **可能原因** API调用量超出配额。 **处理步骤** 请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600007 API的QPS超过配额 **错误信息** The API QPS exceeds the quota. **错误描述** API的QPS超过配额。 **可能原因** API的QPS超过配额。 **处理步骤** 请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600008 接口已经欠费 **错误信息** The API is in arrears. **错误描述** 接口欠费。 **可能原因** 接口欠费。 **处理步骤** 请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600009 API未订购付费套餐 **错误信息** The API has not subscribed to any pay-as-you-go package. **错误描述** API未订购付费套餐。 **可能原因** 未订购付费套餐。 **处理步骤** 请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600010 服务器繁忙，请稍后再试 **错误信息** The server is busy. Please wait and try again. **错误描述** 服务器繁忙。 **可能原因** 服务器繁忙。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600011 服务器异常 **错误信息** Server error. **错误描述** 当发生系统内部错误时，将返回该错误码。 **可能原因** 1.服务器异常。 2.网络不可用。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600012 国家或地区码异常 **错误信息** The country code is not supported. **错误描述** 当传入国家/地区码错误时，将返回该错误码。 **可能原因** 不支持该国家/地区码。 **处理步骤** 更换国家/地区码。 ## 1002600013 当前路由地未知，稍后重试 **错误信息** The current routing location is unknown. Try again later. **错误描述** 当前路由地未知。 **可能原因** 获取当前设备的路由地失败。 **处理步骤** 1. 检查设备网络是否可用。 2. 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600014 地图应用启动失败。 **错误信息** Failed to start the map app. **错误描述** 地图应用启动失败。 **可能原因** 设备未安装地图应用且拉起应用市场地图下载详情页失败。 **处理步骤** 1. 通过应用市场搜索下载地图应用。 2. 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600015 热力图ID已存在 **错误信息** The heatmap ID already exists. **错误描述** 热力图ID已存在。 **可能原因** 热力图ID已存在。 **处理步骤** 尝试更换ID，如果不能解决可以[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600017 该应用缺少地图信号预测功能的权限 **错误信息** The app lacks permission for the map signal prediction capability. **错误描述** 该应用缺少地图信号预测功能的权限。 **可能原因** 该应用缺少地图信号预测功能的权限。 **处理步骤** 尝试[开通信号预测能力](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-map-signal-line#开通信号预测能力)。 ## 1002600018 信号路线中的signalId已存在 **错误信息** signalId in the signal route already exists. **错误描述** 信号路线中的signalId已存在。 **可能原因** 信号路线中的signalId已存在。 **处理步骤** 更改signalId，如果不能解决可以[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600019 路线长度超过最大限制200公里 **错误信息** The route length exceeds the maximum limit of 200 km. **错误描述** 路线长度超过最大限制200公里。 **可能原因** 路线长度超过最大限制200公里。 **处理步骤** 减少路线长度，如果不能解决可以[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600020 无效的运营商 **错误信息** Invalid carrier. **错误描述** 无效的运营商。 **可能原因** 未插SIM卡。 **处理步骤** 检查SIM卡是否正常，如果不能解决可以[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002600021 路由信号不可预测 **错误信息** The route signal is unpredictable. **错误描述** 路由信号不可预测。 **可能原因** 传入的经纬度无法预测出路线结果。 **处理步骤** 建议检查传入的经纬度数据，然后重新调用[信号路线](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapcomponentcontroller#addsignalline)接口。 ## 1002600999 未知错误 **错误信息** Unknown error. **错误描述** 当发生系统内部错误时，将返回该错误码。 **可能原因** 其他未知错误。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002601001 要操作的对象已经不存在 **错误信息** The object to be operated does not exist. **错误描述** 操作的对象不存在。 **可能原因** 操作的对象不存在。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002601002 自定义地图样式文件不存在 **错误信息** The custom map style file does not exist. **错误描述** 自定义地图样式文件不存在。 **可能原因** 1.自定义地图样式文件不存在。 2.设备网络不可用。 **处理步骤** 1.在[Petal Maps Studio](https://developer.petalmaps.com/console/studio/)网站检查样式id是否存在。 2.检查设备网络是否可用。 3.尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002601004 样式内容格式不正确 **错误信息** The style content format is incorrect. **错误描述** 样式内容格式不正确。 **可能原因** 样式内容格式不正确。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002601005 生成自定义组件图标失败 **错误信息** Failed to generate the icon of the custom component. **错误描述** 生成自定义组件图标失败。 **可能原因** 生成自定义组件图标失败。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002602001 起终点无归属国家，或服务错误 **错误信息** The start and end points do not have home countries, or a service error occurred. **错误描述** 起终点无归属国家，或服务错误。 **可能原因** 参数错误。 **处理步骤** 请检查起终点后尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。 ## 1002602002 不支持跨区进行路径规划 **错误信息** Cross-region route planning is not supported. **错误描述** 不支持跨区进行路径规划。 **可能原因** 参数错误。 **处理步骤** 检查入参是否涉及跨区。 ## 1002602003 起始点或结束点超过100个 **错误信息** The number of start points or end points exceed 100. **错误描述** 起始点或结束点超过100个。 **可能原因** 参数错误。 **处理步骤** 检查入参，起点或终点个数是否超限。 ## 1002602004 两点直线距离超过限制的距离 **错误信息** The linear distance between the start point and end point exceeds the upper limit. **错误描述** 两点直线距离超过限制的距离。 **可能原因** 参数错误。 **处理步骤** 检查入参，两点直线距离是否超过接口限制的距离。 ## 1002602005 起点/终点/途经点不支持导航 **错误信息** The start point, end point, or waypoint does not support navigation. **错误描述** 起点/终点/途经点不支持导航。 **可能原因** 参数错误。 **处理步骤** 检查入参。 ## 1002602006 请求点位映射到道路同一点上 **错误信息** The request point is mapped to the same point on the road. **错误描述** 请求点位映射到道路同一点上。 **可能原因** 参数错误。 **处理步骤** 检查入参。 ## 1002603001 空结果 **错误信息** Zero result. **错误描述** 空结果。 **可能原因** 参数错误。 **处理步骤** 检查入参。 ## 1022100001 要操作的地图控制器不存在 **错误信息** The map controller to be operated does not exist. **错误描述** 要操作的地图控制器不存在。 **可能原因** 要操作的地图控制器不存在。 **处理步骤** 尝试重试操作或请通过[在线提单](https://developer.huawei.com/consumer/cn/support/feedback/#/)提交问题。