文件管理错误码
说明：
以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
文件管理子系统错误码由五部分组成，分别是基础文件IO错误码、用户数据管理错误码、公共文件访问错误码、空间统计错误码和端云同步错误码。
基础文件IO错误码
13900001 操作不允许
错误信息
Operation not permitted
错误描述
操作不允许。
可能原因
当前用户文件操作不被允许，URI或path访问未授权。
处理步骤
1.根据当前系统的访问控制机制，应用无法使用分享给其他应用的URI。
2.根据系统Picker的运行机制，通过Picker获取到的URI仅有临时权限，无法持久化保存使用。
3.URI路径不推荐进行拼接，拼接后的URI默认未授权。
13900002 没有这个文件或目录
错误信息
No such file or directory
错误描述
没有此文件或目录。
可能原因
文件或目录不存在。
处理步骤
确认文件路径是否存在。
13900003 没有这样的进程
错误信息
No such process
错误描述
没有此类进程。
可能原因
进程不存在。
处理步骤
1.确认进程是否被意外杀死。
2.确认相关服务是否已启动。
13900004 系统调用被中断
错误信息
Interrupted system call
错误描述
系统调用被中断。
可能原因
系统调用被其他线程中断。
处理步骤
1.检查多线程代码逻辑。
2.重新进行系统调用。
13900005 I/O错误
错误信息
I/O error
错误描述
I/O错误。
可能原因
底层I/O错误，通常与硬件或者驱动设备层故障相关。
-
硬件故障：设备物理损坏导致无法完成I/O指令。
-
通信链路中断：数据传输过程链接断开。
-
驱动程序错误：驱动程序异常或者版本不兼容。
处理步骤
-
检查硬件状态是否正常。
-
检查USB设备等链接是否正常。
-
检查并更新驱动程序。
13900006 没有这个设备或地址
错误信息
No such device or address
错误描述
没有此设备或地址。
可能原因
设备或地址信息错误。
处理步骤
确认设备或地址信息。
13900007 参数列表太长
错误信息
Arg list too long
错误描述
参数列表过长。
可能原因
参数列表过长。
处理步骤
减少参数个数。
13900008 异常的文件描述符
错误信息
Bad file descriptor
错误描述
异常的文件描述符。
可能原因
1.此文件描述符已关闭。
2.读写权限不匹配。
处理步骤
1.确认此文件描述符是否已关闭。
2.确认此文件读写权限是否匹配。
13900009 没有子进程
错误信息
No child processes
错误描述
没有子进程。
可能原因
无法创建子进程。
处理步骤
确认系统中最大进程数。
13900010 资源暂时不可用
错误信息
Try again
错误描述
资源暂时不可用。
可能原因
资源被阻塞。
处理步骤
重新请求资源。
13900011 内存溢出
错误信息
Out of memory
错误描述
内存溢出。
可能原因
内存溢出。
处理步骤
1.确认内存开销。
2.管理系统内存开销。
13900012 拒绝许可
错误信息
Permission denied
错误描述
拒绝许可。
可能原因
1.文件操作被DAC或selinux拦截。
2.文件沙箱路径地址错误。
处理步骤
1.访问被DAC自主式权限控制权限拦截，请排查文件的UGO权限。
2.排查内核日志中是否有avc拦截日志，如果存在avc拦截告警，拦截原因分析请参考SELinux开发说明。
3.确认文件的路径是否为应用内的沙箱路径沙箱路径地址，文件管理系统禁止操作应用沙箱以外的文档。
13900013 错误的地址
错误信息
Bad address
错误描述
错误的地址。
可能原因
地址错误。
处理步骤
确认地址是否正确。
13900014 设备或资源忙
错误信息
Device or resource busy
错误描述
设备或资源忙。
可能原因
请求的资源不可用。
处理步骤
重新请求资源。
13900015 文件存在
错误信息
File exists
错误描述
文件已存在。
可能原因
需创建的文件已存在。
处理步骤
确认文件路径是否正确。
13900016 无效的交叉链接
错误信息
Cross-device link
错误描述
无效的交叉链接。
可能原因
跨设备链接失败。
处理步骤
确认跨设备是否正常。
13900017 设备不存在
错误信息
No such device
错误描述
设备不存在。
可能原因
设备未被识别。
处理步骤
确认设备间连接是否正常。
13900018 不是一个目录
错误信息
Not a directory
错误描述
不是一个目录。
可能原因
此路径不是文件夹目录。
处理步骤
确认路径是否正确。
13900019 是一个目录
错误信息
Is a directory
错误描述
是一个目录。
可能原因
此路径是文件夹目录。
处理步骤
确认路径是否正确。
13900020 无效的参数
错误信息
Invalid argument
错误描述
无效参数。
可能原因
输入参数非法。
处理步骤
确认参数合法性。
13900021 打开太多的文件描述符
错误信息
File table overflow
错误描述
打开太多的文件描述符。
可能原因
进程打开过多的文件描述符。
处理步骤
关闭不相关的文件描述符。
13900022 打开的文件过多
错误信息
Too many open files
错误描述
打开的文件过多。
可能原因
系统打开过多的文件。
处理步骤
关闭不需要的文件。
13900023 文本文件忙
错误信息
Text file busy
错误描述
文本文件忙。
可能原因
程序的可执行文件正在被使用。
处理步骤
关闭正在调试的程序。
13900024 文件太大
错误信息
File too large
错误描述
文件过大。
可能原因
文件大小超出最大文件大小。
处理步骤
确认文件大小是否满足最大文件大小。
13900025 设备上没有空间
错误信息
No space left on device
错误描述
设备上剩余空间不足。
可能原因
设备存储空间不足。
处理步骤
清理设备存储空间。
13900026 非法移位
错误信息
Illegal seek
错误描述
非法移位。
可能原因
在管道或FIFO中使用seek。
处理步骤
确认seek使用。
13900027 只读文件系统
错误信息
Read-only file system
错误描述
只读文件系统。
可能原因
文件系统只支持读。
处理步骤
确认文件是否只读。
13900028 太多的链接
错误信息
Too many links
错误描述
链接过多。
可能原因
文件已达最大链接数。
处理步骤
清理无用链接。
13900029 资源死锁错误
错误信息
Resource deadlock would occur
错误描述
资源死锁错误。
可能原因
资源死锁。
处理步骤
终止死锁进程。
13900030 文件名太长
错误信息
Filename too Long
错误描述
文件名过长。
可能原因
文件名超过最大长度255字节。
处理步骤
确认文件名长度。
13900031 功能没有实现
错误信息
Function not implemented
错误描述
功能没有实现。
可能原因
系统不支持此功能。
处理步骤
确认系统版本。
13900032 目录非空
错误信息
Directory not empty
错误描述
目录非空。
可能原因
指定目录不为空。
处理步骤
1.确认目录路径。
2.确认路径为空。
13900033 符号链接层次太多
错误信息
Too many symbolic links encountered
错误描述
符号链接层次过多。
可能原因
符号链接层次过多。
处理步骤
清理无关符号链接。
13900034 操作被阻塞
错误信息
Operation would block
错误描述
操作被阻塞。
可能原因
操作被阻塞。
处理步骤
重新进行操作。
13900035 请求描述符无效
错误信息
Invalid request descriptor
错误描述
请求描述符无效。
可能原因
文件描述符非法。
处理步骤
确认文件描述符是否合法。
13900036 设备不是字符流
错误信息
Device not a stream
错误描述
设备不是字符流。
可能原因
文件描述符指向非流设备。
处理步骤
确认文件描述符是否指向流设备。
13900037 无可用数据
错误信息
No data available
错误描述
无可用数据。
可能原因
数据不可用。
处理步骤
重新请求数据。
13900038 对于定义的数据类型,值太大
错误信息
Value too large for defined data type
错误描述
变量值超出数据类型规定的最大值。
可能原因
值超出所定义的数据类型范围。
处理步骤
修改数据类型。
13900039 文件描述符在异常状态
错误信息
File descriptor in bad state
错误描述
文件描述符在异常状态。
可能原因
文件描述符损坏。
处理步骤
确认文件描述符合法性。
13900040 应该重新启动被中断的系统调用
错误信息
Interrupted system call should be restarted
错误描述
应该重新启动被中断的系统调用。
可能原因
系统调用被中断。
处理步骤
重新进行系统调用。
13900041 超出磁盘配额
错误信息
Quota exceeded
错误描述
超出磁盘配额。
可能原因
磁盘空间不足。
处理步骤
清理磁盘存储空间。
13900042 未知错误
错误信息
Unknown error
错误描述
未知错误。
可能原因
内部错误。
处理步骤
1.重试接口。
2.重启服务。
13900043 没有可用的锁
错误信息
No record is locks available
错误描述
没有可用的锁。
可能原因
系统资源不足。
处理步骤
释放锁资源后重试。
13900044 网络无法访问
错误信息
Network is unreachable
错误描述
网络无法访问。
可能原因
网络异常。
处理步骤
检查网络状态，确认状态正常。
13900045 连接失败
错误信息
Connection failed
错误描述
连接失败。
可能原因
设备、Wi-Fi或蓝牙状态异常，导致建立链接失败。
处理步骤
1.检查设备，确认设备状态正常。
2.检查Wi-Fi和蓝牙，确认状态正常。
13900046 软件造成连接中断
错误信息
Software caused connection abort
错误描述
软件造成连接中断。
可能原因
设备下线或Wi-Fi、蓝牙断连。
处理步骤
1.检查设备，确认设备状态正常。
2.检查Wi-Fi和蓝牙，确认状态正常。
用户数据管理错误码
14000001 文件名非法
错误信息
Invalid file name
可能原因
文件名存在非法字符。
处理步骤
删除非法字符。
14000002 非法URI
错误信息
Invalid URI
可能原因
URI不合法。
处理步骤
直接使用查询获取的URI。
14000003 文件后缀非法
错误信息
Invalid file name extension
可能原因
按照文件类型命名。
处理步骤
检查文件名后缀。
14000004 文件已进入回收站
错误信息
File already in the recycle bin
可能原因
文件已经被删除进入回收站。
处理步骤
检查文件是否已经进入回收站。
14000011 系统内部错误
错误信息
System inner fail
可能原因
系统异常，发生未知错误。
处理步骤
清理后台，或重启设备。
14000014 成员名非法
错误信息
Member is not a valid PhotoKey
可能原因
传入的字符串不是类或接口的成员名。
处理步骤
确保传入的字符串为类或接口的成员名。
空间统计错误码
13600001 IPC通信失败
错误信息
IPC error
错误描述
IPC通信失败。
可能原因
调用服务不存在。
处理步骤
检查服务是否启动。
13600002 文件系统类型不支持
错误信息
File system not supported
错误描述
文件系统类型不支持。
可能原因
操作的文件系统类型不支持。
处理步骤
修改为正确的文件系统类型。
13600003 挂载失败
错误信息
Mount failed
错误描述
挂载失败。
可能原因
调用挂载命令失败。
处理步骤
拔卡尝试重新挂载。
13600004 卸载失败
错误信息
Unmount failed
错误描述
卸载失败。
可能原因
设备繁忙。
处理步骤
检查外卡文件是否被线程占用, 杀掉占用线程。
13600005 卷状态错误
错误信息
Incorrect volume state
错误描述
卷状态错误。
可能原因
操作的卷状态错误。
处理步骤
检查当前卷状态是否正确。
13600006 创建目录或者节点失败
错误信息
Failed to create the directory or node
错误描述
创建目录或者节点失败。
可能原因
目录或节点已存在。
处理步骤
检查待创建目录或节点是否存在。
13600007 删除目录或者节点失败
错误信息
Failed to delete the directory or node
错误描述
删除目录或者节点失败。
可能原因
目录或节点已删除。
处理步骤
检查待删除目录或节点是否存在。
13600008 操作对象不存在
错误信息
No such object
错误描述
操作对象不存在。
可能原因
1.输入错误的卷id。
2.输入错误的包名。
处理步骤
1.检查输入的卷是否存在。
2.检查输入的应用包名是否存在。
13600009 用户id超出范围
错误信息
User ID out of range
错误描述
用户id超出范围。
可能原因
输入错误的用户id。
处理步骤
检查输入的用户id是否处于正常范围。
公共文件访问错误码
14300001 IPC通信失败
错误信息
IPC error
错误描述
IPC通信失败。
可能原因
1.server端服务不在。
2.extension机制异常。
处理步骤
检查server端服务是否存在。
14300002 URI格式错误
错误信息
Invalid URI
错误描述
URI格式错误。
可能原因
使用非法URI。
处理步骤
检查URI格式。
14300003 查询server端ability信息失败
错误信息
Failed to obtain the server ability information
错误描述
查询server端ability信息失败。
可能原因
BMS接口异常。
处理步骤
系统基础能力问题，请向OpenHarmony团队反馈，获取支持。
14300004 js-server实际返回的结果异常
错误信息
Incorrect result returned by js-server
错误描述
js-server实际返回的结果异常。
可能原因
server端返回实际数据不当。
处理步骤
server端返回值检查。
14300005 notify注册失败
错误信息
Failed to register notify
错误描述
notify注册失败。
可能原因
1.server端服务不在。
2.extension机制异常。
处理步骤
检查server端服务是否存在。
14300006 notify移除失败
错误信息
Failed to unregister notify
错误描述
notify移除失败。
可能原因
1.server端服务不在。
2.extension机制异常。
处理步骤
检查server端服务是否存在。
14300007 notify代理初始化失败
错误信息
Failed to initialize the notify agent
错误描述
notify代理初始化失败。
可能原因
未注册就去取消notify。
处理步骤
检查是否注册过。
14300008 js-server端通知代理失败
错误信息
Failed to notify the agent
错误描述
js-server端通知代理失败。
可能原因
1.服务不在。
2.extension机制异常。
处理步骤
检查client是否异常。
端云同步错误码
22400001 云端状态未ready
错误信息
Cloud status not ready
可能原因
1.未启用云。
2.应用云同步开关未打开。
处理步骤
1.检查是否账号登录。
2.检查云同步开关是否打开。
22400002 网络不可用
错误信息
Network unavailable
可能原因
设备未联网或网络不可用。
处理步骤
检查网络状态。
22400003 告警电量
错误信息
Low battery level
可能原因
电量过低。
处理步骤
充电状态或电量恢复后再执行。
22400004 入参请求超过最大限制
错误信息
Exceeded the maximum limit
可能原因
请求数量超过接口规格定义的上限。
处理步骤
检查入参，保证请求数量符合规格要求。
22400005 内部错误
错误信息
Inner error
可能原因
1.系统内部数据库请求失败或者SQL执行失败。
2.系统出现空指针等异常。
3.系统内存不足或内存异常。
4.JS框架异常。
处理步骤
系统基础能力问题，请向OpenHarmony团队反馈，获取支持。
22400006 已经有同类型任务正在运行
错误信息
The same task is already in progress
可能原因
有同类型任务正在运行。
处理步骤
等待现有同类型任务完成，或通过调用对应业务的stop接口终止现有任务后，再触发新任务。
22400007 指定用于替换原始文件的历史版本文件不存在
错误信息
The version file specified to replace the original file does not exist
可能原因
历史版本文件未下载或已删除。
处理步骤
重新下载指定的历史版本文件，保证文件存在。