HarmonyOS API：错误码参考

版本：v3.1 Beta

首选项错误码

更新时间: 2023-02-17 09:19

15500010 删除首选项失败

错误信息

Failed to delete preferences.

错误描述

删除首选项失败。

可能原因

系统错误导致文件删除失败，可能原因如下：

1. 文件名称不正确。
2. 文件路径不正确。

处理步骤

1. 检查文件名称是否正确。
2. 检查文件路径是否正确。

上传下载错误码

更新时间: 2023-02-17 09:19

13400001 文件操作异常

错误信息

File operation error.

错误描述

在调用uploadFile或downloadFile接口时，文件权限不足或操作失败。

可能原因

该错误码表示文件操作异常，可能原因文件权限不足。

处理步骤

请检查文件权限是否合理。

13400002 文件路径异常

错误信息

Bad file path.

错误描述

在调用uploadFile或downloadFile接口时，文件路径不合法。

可能原因

该错误码表示文件路径异常，可能原因文件路径错误。

处理步骤

请检查上传下载的文件路径是否正确。

13400003 服务异常

错误信息

Task manager service error.

错误描述

在调用downloadFile接口时，下载任务后台服务失败。

可能原因

该错误码表示服务异常，可能原因任务创建失败

处理步骤

请检查任务配置是否正确。

NFC错误码

更新时间: 2023-02-17 09:19

3100101

错误信息

NFC opening or closing state is abnormal in service.

错误描述

NFC服务内部执行NFC打开或关闭异常。

可能原因

和NFC服务建立通信异常。

处理步骤

重新执行打开或关闭NFC。

3100201

错误信息

Tag running state is abnormal in service.

错误描述

NFC服务执行Tag业务逻辑遇到错误。

可能原因

1. Tag参数值和实际调用函数要求不匹配。
2. Tag操作时，NFC状态是关闭的。
3. Tag操作前，已经处在断开状态。
4. Tag芯片返回错误状态或响应超时。
5. 和NFC服务没有建立绑定关系，无法调用接口。

处理步骤

1. 检查NFC参数是否和所调用接口匹配。
2. 打开设备NFC。
3. 先调用连接，再执行读写操作。
4. 重新触碰读取卡片。
5. 退出应用后，重新读取卡片。

RPC错误码

更新时间: 2023-02-17 09:19

从API version 9起，IPC支持异常返回功能。错误码对应数值及含义如下。

1900001 系统调用mmap失败

错误信息

Call mmap function failed.

错误描述

执行系统调用mmap失败。

可能原因

1. 映射区域过大。
2. 系统内存压力大，没有足够内存可以用来进行映射。

处理步骤

1. 请检查调用Ashmem::create()时是否指定了超大内存；
2. 请检查执行映射时系统是否有足够的内存可用。

1900002 系统调用ioctl失败

错误信息

Call os ioctl function failed.

错误描述

在共享内存文件描述符上执行系统调用ioctl失败。

可能原因

1. 设置的参数为内核非法参数；
2. 设置的类型超过了共享内存映射时指定的类型。

处理步骤

1. 请检查调用指定的参数是否来自Ashmem类的PROT_EXEC、PROT_READ和PROT_WRITE；
2. 请检查指定的参数是否为映射共享内存时所指类型的子集。

1900003 共享内存写数据失败

错误信息

Write to ashmem failed.

错误描述

向共享内存写数据失败。

可能原因

1. 单次写或者连续写的总内容超过了映射的共享内存大小；
2. 没有对共享内存设置PROT_WRITE模式。

处理步骤

1. 请检查当前向共享内存所写内容是否已经超过了映射的总大小；
2. 请检查是否设置了PROT_WRITE保护权限。

1900004 共享内存读数据失败

错误信息

Read from ashmem failed.

错误描述

从共享内存读数据失败。

可能原因

1. 单次写或者连续写的总内容超过了映射的共享内存大小；
2. 没有对共享内存设置PROT_READ模式。

处理步骤

1. 请检查当前向共享内存所写内容是否已经超过了映射的总大小；
2. 请检查是否设置了PROT_READ保护权限。

1900005 ipc对象权限错误

错误信息

Only proxy object permitted.

错误描述

只有proxy对象允许该操作。

可能原因

在RemoteObject对象上调用了只有RemoteProxy对象支持的方法。

处理步骤

请检查是否在RemoteObject对象上调用了只有RemoteProxy对象支持的方法。

1900006 ipc对象权限错误

错误信息

Only remote object permitted.

错误描述

只有remote对象允许该操作。

可能原因

在RemoteProxy对象上调用了只有RemoteObject对象支持的方法。

处理步骤

请检查是否在RemoteProxy对象上调用了只有RemoteObject对象支持的方法。

1900007 远端对象通信失败

错误信息

Communication failed.

错误描述

和远端对象进行进程间通信失败。

可能原因

1. 远端对象已经销毁；
2. 远端对象发生了销毁然后重新创建，本端持有的代理对象已经过期。

处理步骤

1. 请检查远端对象是否已经销毁；
2. 请检查是否注册了死亡监听，并且远端对象发生析构又重新创建。

1900008 非法的ipc对象

错误信息

Proxy or remote object is invalid.

错误描述

非法的代理对象或者远端对象。

可能原因

1. 代理对象已经失效；
2. 远端对象已经销毁。

处理步骤

1. 请检查proxy对象获取过程是否有异常；
2. 请检查远端对象是否已经析构。

1900009 向MessageSequence写入数据失败

错误信息

Write data to message sequence failed.

错误描述

向MessageSequence写数据失败。

可能原因

sequence默认空间已满。

处理步骤

请使用MessageSequence提供的获取缓冲区空间相关方法确认是否还有剩余空间。

1900010 读取MessageSequence数据失败

错误信息

Read data from message sequence failed.

错误描述

读取MessageSequence数据失败。

可能原因

读取和写入顺序不一致。

处理步骤

请检查读取的顺序和写入的顺序保持严格一致。

1900011 内存分配失败

错误信息

Sequence memory alloc failed.

错误描述

序列化过程中内存分配失败。

可能原因

写入的数据过大。

处理步骤

请检查写入的数据或者设置的参数是否过大。

1900012 JS方法失败

错误信息

Call JS callback function failed.

错误描述

执行JS回调方法失败。

可能原因

业务的JS方法返回失败。

处理步骤

请检查业务JS方法是否执行成功。

1900013 系统调用dup失败

错误信息

Call os dup function failed.

错误描述

执行系统调用dup失败。

可能原因

1. 进程的文件句柄资源已经耗尽；
2. 入参fd已经被关闭。

处理步骤

1. 请检查入参fd是否依然有效；
2. 请排查进程是否已经耗尽了fd资源。

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/errorcode-rpc-0000001477981537-V3?catalogVersion=V3​​