文件管理错误码
说明：
以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
文件管理子系统错误码由五部分组成，分别是基础文件IO错误码、用户数据管理错误码、公共文件访问错误码、空间统计错误码和端云同步错误码。
基础文件IO错误码
13900001 操作不允许
错误信息
Operation not permitted
错误描述
操作不允许。
可能原因
当前用户文件操作不被允许，URI或path访问未授权。
处理步骤
1.根据当前系统的访问控制机制，应用无法使用分享给其他应用的URI。
2.根据系统Picker的运行机制，通过Picker获取到的URI仅具有临时权限，应用退出或设备重启后如需继续访问，需按授权持久化流程处理。
3.URI路径不推荐进行拼接，拼接后的URI默认未授权。
13900002 没有这个文件或目录
错误信息
No such file or directory
错误描述
没有此文件或目录。
可能原因
1.传入路径不是沙箱路径，或在应用沙箱内不存在该文件或目录。
2.接口仅支持沙箱路径时，传入了URI。
3.接口支持URI时，传入了自行拼接或二次编/解码后的不正确的URI。
4.接口仅支持'utf-8'编码的文件或目录名，使用其他编码可能导致文件找不到。
5.创建文件时，路径中目标文件所在的目录不存在。
处理步骤
1.检查传入的路径是否为沙箱路径，在沙箱内是否存在。
2.检查是否传错参数类型。
3.检查是否传入了自行拼接或二次编/解码后的不正确的URI。
4.检查文件或目录名编码格式是否是'utf-8'。
5.创建文件时，检查文件父级目录是否存在。
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和蓝牙，确认状态正常。
13900050 内部资源错误
错误信息
Internal resource error.
错误描述
内部资源错误。
可能原因
系统内部资源分配失败。
处理步骤
重新运行当前代码。
13900051 缓冲区读写越界
错误信息
Buffer read/write out of bounds.
错误描述
mmap缓冲区读写越界。
可能原因
读写的数据长度超过了mmap映射区的剩余可用空间。
处理步骤
1.调用remaining确认映射区的剩余可用空间。
2.如需操作更大范围，可先调用setLimit调整限制值。
13900052 mmap缓冲区已释放
错误信息
Mmap buffer released.
错误描述
mmap缓冲区已释放。
可能原因
1.对已调用unmap/unmapSync释放的缓冲区进行操作。
2.FileMapping对象的内部状态无效。
处理步骤
1.确认mmap缓冲区是否已调用unmap/unmapSync释放。
2.代码如果已经调用过unmap/unmapSync接口，则需重新调用mmap/mmapSync接口建立新的映射。
13900053 mmap缓冲区只读
错误信息
Read-only mmap buffer.
错误描述
mmap缓冲区只读。
可能原因
以只读模式映射的缓冲区尝试进行写操作。
处理步骤
重新调用mmap/mmapSync，将映射模式设置为读写模式或私有模式。
13900054 mmap缓冲区不可访问
错误信息
Mmap buffer is inaccessible.
错误描述
mmap缓冲区不可访问。
可能原因
系统内存映射异常导致缓冲区指针失效。
处理步骤
13900055 mmap映射类型不支持该操作
错误信息
Mmap operation not supported.
错误描述
mmap映射类型不支持该操作。
可能原因
msync写入磁盘时，映射区为只读模式或私有模式。
处理步骤
重新调用mmap/mmapSync，将映射模式设置为读写模式。
13900056 mmap不支持映射此文件
错误信息
Mmap does not support mapping this file.
错误描述
mmap不支持映射此文件。
可能原因
目标文件不是常规文件，如管道、socket、设备文件等。
处理步骤
请使用read、write或Stream等文件访问接口替代mmap。
用户数据管理错误码
14000001 文件名非法
错误信息
Invalid file name
错误描述
文件名非法。
可能原因
文件名存在非法字符。
处理步骤
删除非法字符。
14000002 非法URI
错误信息
Invalid URI
错误描述
非法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
错误描述
成员名非法。
可能原因
传入的字符串不是类或接口的成员名。
处理步骤
确保传入的字符串为类或接口的成员名。
14000016 操作类型不支持
错误信息
Operation Not Support
错误描述
当前操作类型不被支持。
可能原因
-
对非Moving Photo类型的资源执行了Moving Photo相关操作。
-
对已通过添加/移动/移除的资源，再次操作相同的URI。
-
之前的资源创建/修改请求还未提交就再次修改（包含 CREATE_FROM_URI/GET_WRITE_CACHE_HANDLER/ADD_RESOURCE 操作）。
-
对非视频类型（MediaType.VIDEO）的资源执行了视频增强等视频专属操作。
-
对非用户相册或高亮相册执行了不允许的操作。
处理步骤
-
确认资源类型。
- 如执行Moving Photo相关操作（如setMovingPhotoEffectMode）需确保资源是Moving Photo类型。
- 如执行视频增强操作（如setVideoEnhancementAttr）需要确保MediaType为VIDEO类型。
-
避免重复操作。
- 在调用addAssets/removeAssets/moveAssets前，检查是否已执行过此操作，避免连续重复调用。
-
完成提交后再修改。
- 在调用createImageAssetRequest/createVideoAssetRequest/getWriteCacheHandler/addResource后，需调用applyChanges提交生效。
- 提交生效后才能对创建的资产发起新的修改请求。
-
确认相册类型。
- addAssets/removeAssets 仅支持用户相册和高亮相册。
- 系统相册（如相机、截屏相册）不支持这些操作。
空间统计错误码
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是否处于正常范围。
13600010 输入参数非法
错误信息
The input parameter is invalid.
错误描述
用户输入参数非法。
可能原因
输入错误的参数。
处理步骤
检查输入的参数是否处于正常范围。
13600011 上报指定业务空间占用失败
错误信息
Failed to report the specified business space usage.
错误描述
上报指定业务空间占用失败。
可能原因
与数据库交互异常。
处理步骤
重启设备后重试。
13600012 查询指定业务空间占用失败
错误信息
Failed to query the specified business space usage.
错误描述
查询指定业务空间占用失败。
可能原因
与数据库交互异常。
处理步骤
重启设备后重试。
13600013 查询所有业务空间占用情况失败
错误信息
Failed to query all business space usage.
错误描述
查询所有业务空间占用情况失败。
可能原因
与数据库交互异常。
处理步骤
重启设备后重试。
13600015 获取磁盘空间占用信息失败
错误信息
Failed to traverse the query data partition directory.
错误描述
获取磁盘空间占用信息失败。
可能原因
底层文件系统异常。
处理步骤
重启设备后重试。
13600016 获取文件系统inode数失败
错误信息
Failed to query the inode information of the data partition.
错误描述
获取数据分区的inode信息失败。
可能原因
底层文件系统异常。
处理步骤
重启设备后重试。
13600017 获取当前应用的inode占用量失败
错误信息
Failed to query the inode information of the application.
错误描述
获取当前应用的inode占用量失败。
可能原因
底层文件系统异常。
处理步骤
重启设备后重试。
13600018 查询系统数据大小失败
错误信息
Failed to query the system data size.
错误描述
查询系统数据大小失败。
可能原因
底层文件系统异常。
处理步骤
重启设备后重试。
13600021 获取分区表失败
错误信息
Get partition table failed.
错误描述
获取分区表失败。
可能原因
1.磁盘处于不可操作状态。
2.内部流程执行失败或内部错误。
处理步骤
1.建议重新插拔设备后重试。
2.请向OpenHarmony团队反馈，获取支持。
13600022 创建分区失败
错误信息
Create partition failed.
错误描述
创建分区失败。
可能原因
1.分区参数非法。
2.磁盘未分配空间不足。
3.内部流程执行失败或内部错误。
处理步骤
1.确认分区参数（起始扇区、结束扇区）是否在有效范围内。
2.确认磁盘是否有足够的未分配空间。
3.请向OpenHarmony团队反馈，获取支持。
13600023 删除分区失败
错误信息
Delete partition failed.
错误描述
删除分区失败。
可能原因
1.磁盘处于不可操作状态。
2.内部流程执行失败或内部错误。
处理步骤
1.建议重新插拔设备后重试。
2.请向OpenHarmony团队反馈，获取支持。
13600024 光盘为空
错误信息
Empty disc.
错误描述
光盘为空。
可能原因
光盘中没有数据或未被正确识别。
处理步骤
1.确认光盘已正确放入光驱。
2.确认光盘包含有效数据。
13600025 写入ISO文件失败
错误信息
Failed to write the ISO file.
错误描述
写入ISO文件失败。
可能原因
1.ISO文件损坏或格式不正确。
2.写入过程中发生I/O错误。
3.光盘写入权限不足。
处理步骤
1.检查ISO文件完整性。
2.确认光盘状态正常且可写入。
3.重试写入操作。
13600026 擦除操作失败
错误信息
Erase operation failed.
错误描述
擦除操作失败。
可能原因
擦除过程中光驱被用户拔出。
处理步骤
重新插入光驱，并等待擦除完成。
13600027 源数据未找到
错误信息
Source data not found.
错误描述
源数据未找到。
可能原因
1.源文件路径错误或文件不存在。
2.源数据已被删除或移动。
处理步骤
1.确认源文件路径正确。
2.确认源文件存在且可访问。
13600028 刻录操作失败
错误信息
Burn operation failed.
错误描述
刻录操作失败。
可能原因
1.光驱硬件故障或连接异常。
2.刻录过程中断或超时。
3.光盘质量不佳或已损坏。
处理步骤
1.检查光驱已连接且处于正常识别的空闲状态。
2.更换质量良好的光盘。
3.降低刻录速度后重试。
13600029 无正在进行的操作
错误信息
No ongoing operation.
错误描述
无正在进行的操作。
可能原因
查询不存在或未开始的刻录任务。
处理步骤
确认是否有正在进行的刻录操作。
13600030 校验失败
错误信息
Verification failed.
错误描述
校验失败。
可能原因
1.刻录数据与源数据不一致。
2.光盘读取错误。
3.数据传输过程中出现错误。
处理步骤
1.重新进行刻录操作。
2.检查光盘质量和光驱状态。
3.验证源数据完整性。
13600031 数据不匹配
错误信息
Data mismatch.
错误描述
数据不匹配。
可能原因
刻录后的数据与原始源数据存在差异。
处理步骤
1.重新刻录并校验数据。
2.检查源文件在刻录过程中是否被修改。
3.更换光盘或光驱后重试。
13600032 格式化分区失败
错误信息
Format partition failed.
错误描述
格式化分区失败。
可能原因
1.磁盘处于不可操作状态。
2.内部流程执行失败或内部错误。
处理步骤
1.建议重新插拔设备后重试。
2.请向OpenHarmony团队反馈，获取支持。
公共文件访问错误码
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
可能原因
历史版本文件未下载或已删除。
处理步骤
重新下载指定的历史版本文件，保证文件存在。