目录

ArkTS API 错误码

以下仅介绍本模块特有错误码，详情请参见通用错误码说明文档。若您的问题仍无法解决，请通过在线提单提交问题，华为支持人员会及时处理。

1023801001 系统内部错误

错误信息

System service exception.

错误描述

系统内部错误

可能原因

系统处于非安全状态（如设备未解锁），或者硬件故障。

处理步骤

  1. 确认系统状态正常后重试。
  2. 如问题仍存在，请通过在线提单提交问题。

1023802001 目标文件不存在

错误信息

File not found.

错误描述

目标路径的文件不存在。

可能原因

目标路径配置错误或文件已被删除。

处理步骤

请确认目标路径及文件状态。

1023802002 该路径不允许访问/处置

错误信息

Access and disposal denied for this path.

错误描述

目标路径不允许访问或处置。

可能原因

目标路径超出允许文件访问限制或文件处置限制，如权限级别、应用沙箱等限制。

处理步骤

请确认路径是否超出允许访问限制和处置限制。

1023802003 文件名冲突

错误信息

A file with the same name already exists in the restored path.

错误描述

恢复路径中有重名文件。

可能原因

新旧文件同名导致恢复失败。

处理步骤

请检查恢复路径中是否有重名文件，可通过改名、删除旧文件等方式解决错误。

1023803001 尝试访问其他用户文件

错误信息

Access to other users' files is restricted.

错误描述

目标路径是其他用户的文件。

可能原因

非本用户账户下的文件资源。

处理步骤

确认当前操作用户身份并变更路径至有效目录。

1023804001 文件类型无效

错误信息

Invalid file type.

错误描述

目标路径的文件类型无效。

可能原因

当前处置仅支持单文件处置，不支持目录。

处理步骤

请检查路径是否为单文件，否则将目标改为单一文件并重新发起操作。

1023804002 不支持处置，推荐自行处置

错误信息

Disposal is not supported. Please handle it manually.

错误描述

目标路径不支持处置。

可能原因

目标路径为应用包体路径，推荐采用以下方式处置：

  1. 禁止应用运行。
  2. 卸载应用。

处理步骤

请检查路径是否为应用包体路径，并选择合适的处置方式。具体处置方式请参见文件访问限制和文件处置限制。

1023804003 操作无效

错误信息

Invalid operation.

错误描述

请求的隔离ID无效。

可能原因

请求ID格式错误或已无效。

处理步骤

请检查隔离ID是否与应用中存储一致，且该隔离ID对应的文件是否为被隔离状态（即存在且未被释放的隔离记录）。

1023805001 隔离区空间不足

错误信息

Quarantine storage space is full.

错误描述

隔离区空间不足。

可能原因

隔离区磁盘满载或达到容量上限。

处理步骤

  1. 查询当前隔离区占用空间及状态。
  2. 使用隔离删除接口removeIsolatedFile对隔离区进行空间清理。

1023806001 数据库损坏

错误信息

Database corruption detected.

错误描述

数据库损坏。

可能原因

表结构异常或连接失败。

处理步骤

  1. 执行初步自检命令或查看日志获取详细错误信息。
  2. 如问题仍存在，请通过在线提单提交问题。

1023807001 进程不存在

错误信息

Process not found.

错误描述

要求处置的进程不存在，或已结束运行。

可能原因

进程ID输入错误或进程已自行退出。

处理步骤

确认传入的进程ID正确，建议通过任务管理器或其他工具核实目标进程的实际PID。

1023807002 系统进程不允许处置

错误信息

Access and disposal are denied for this process.

错误描述

目标进程为系统关键进程，不允许处置。

可能原因

进程为系统进程，不允许处置。

处理步骤

若目标进程不属于系统进程，请通过在线提单提交问题。

1023807003 其他用户进程不允许处置

错误信息

Access to other users' processes is not allowed.

错误描述

目标进程归属于其他用户，当前用户无权限对该进程执行处置操作。

可能原因

目标进程由其他用户启动。

处理步骤

检查目标进程ID是否属于当前用户。