00401000 获取包名信息失败
错误信息
The bundleName attribute does not exist.
错误描述
获取包名信息失败。
可能原因
app.json5文件的bundleName为空或者缺少bundleName配置。
处理步骤
检查app.json5文件的bundleName是否正确。
00401001 attach调试获取不到product
错误信息
The product to debug cannot be empty.
错误描述
attach调试获取不到product。
可能原因
当前模块配置的product不正确。
处理步骤
检查工程级build-profile.json5文件中对应模块的applyToProducts配置是否正确，详细配置可以参考构建定义的目标产物。
00401002 attach调试获取不到target
错误信息
The target to debug cannot be empty.
错误描述
attach调试获取不到target。
可能原因
当前模块配置的target不正确。
处理步骤
检查工程级build-profile.json5文件中对应模块的applyToProducts配置是否正确，详细配置可以参考构建定义的目标产物。
00401003 启动调试失败
错误信息
Failed to start debugging. Click the Debug button again to retry.
错误描述
启动调试失败。
可能原因
启动调试异常。
处理步骤
点击Debug按钮重新启动调试。
00401004 SysCap能力校验不通过
错误信息
Please try to match the API version of the device and the app. The current device does not contain the following SysCap attributes in the rpcid.json file: XXX. Make sure the device supports all the SysCap attributes required for running the app.
错误描述
设备缺少SysCap能力，应用需要的XXX能力在当前连接的设备不支持。
可能原因
设备版本和应用不配套。
处理步骤
- 方式一：升级设备系统版本。
- 方式二：在hap模块的src/main目录下新建syscap.json文件，移除错误信息中不支持的SysCap。
以SystemCapability.Security.DeviceAuth为例：
// entry/src/main/syscap.json { "devices": { "general": ["phone"] // 同module.json5中的deviceTypes }, "production": { "removedSysCaps": [ "SystemCapability.Security.DeviceAuth" ] } }
00401005 未指定Ability
错误信息
Error running entry : Ability not specified.
错误描述
未指定Ability。
可能原因
在运行/调试配置面板中选择Specified Ability后，没有指定Ability。
处理步骤
打开运行/调试配置面板，在Specified Ability下设置Ability。
00401006 预览器不支持以release构建模式进行调试
错误信息
Cannot debug the project in previewer when its build mode is release.
错误描述
预览器不支持以release构建模式进行调试。
可能原因
当前使用预览器调试，并且构建模式是release。
处理步骤
修改构建模式为debug后再次启动调试。
00401007 工程同步过程中不能运行/调试
错误信息
Project sync is in progress. Wait until it is complete before you start running or debugging.
错误描述
工程正在同步中，需要等待工程同步完成后再启动运行/调试。
可能原因
在工程同步过程中启动运行/调试。
处理步骤
等待工程同步完成后再启动运行/调试。
00401008 运行/调试配置面板中的模块为空
错误信息
No module found. Make sure the project sync is completed successfully and the module is set in Edit Configuration > General.
错误描述
当前运行/调试配置面板中的模块为空。
可能原因
工程同步失败。
处理步骤
重新同步工程并确保同步成功。
00401009 运行获取不到target
错误信息
The target can not be empty. Check the build-profile.json5 file of the project root directory and make sure the targets of the modules in configuration is set to specified product: default in applyToProducts.
错误描述
运行时target不能为空。
可能原因
当前模块配置的target不正确。
处理步骤
检查工程级build-profile.json5文件中对应模块的applyToProducts配置是否正确，详细配置可以参考构建定义的目标产物。
00401010 运行获取不到product
错误信息
The product can not be empty.
错误描述
运行时product不能为空。
可能原因
product配置不正确。
处理步骤
检查工程级build-profile.json5文件中对应模块的applyToProducts配置是否正确，详细配置可以参考构建定义的目标产物。
00401011 没有启动任何Ability时，无法运行或调试应用
错误信息
Cannot run or debug the app when no ability is launched. Specify an ability (the default or any specified one) to launch under Launch Options in Run/Debug Configurations, and then try again.
错误描述
当没有启动任何Ability时，无法运行或调试应用。请在运行/调试配置面板中的“启动选项”下指定一个Ability（default或任意指定一个），然后重试。
可能原因
运行/调试配置面板的Launch Options为Nothing。
处理步骤
请在运行/调试配置面板中的“启动选项”下指定一个Ability（default或任意指定一个），然后重试。
00401012 预览器调试不支持ExtensionAbility
错误信息
Debugging with Previewer does not support the ExtensionAbility type.
错误描述
预览器调试不支持ExtensionAbility。
可能原因
预览器调试时，运行/调试配置面板的Specified Ability是ExtensionAbility。
处理步骤
请在运行/调试配置面板中的“启动选项”下指定一个Ability（default或指定一个非ExtensionAbility），然后重试。
00401013 预览器调试不支持此应用
错误信息
Previewer does not support this app.
错误描述
预览器调试不支持此应用。
可能原因
- 不支持FA模型工程。
- 不支持API 10以下工程。
处理步骤
- 使用预览器运行调试API 10及以上Stage工程。
- 重新选择其他设备/仿真器运行调试。
00401014 仿真器不支持此应用
错误信息
Simulator does not support this app.
错误描述
仿真器不支持此应用。
可能原因
应用不是Lite Wearable应用。
处理步骤
- 如果是非Lite Wearable工程，请使用真机或者模拟器运行。
- 如果是Lite Wearable工程，确保config.json文件的设备列表中包含liteWearable。
00401015 请先选择设备
错误信息
Select a device first.
错误描述
请先选择设备。
可能原因
没有选择设备。
处理步骤
请连接设备，或者启动模拟器并选择设备，再启动运行或调试。
00401016 当前操作出现异常，请重新运行
错误信息
Some exceptions occurred in this operation, please re-run.
错误描述
当前操作出现异常，请重新运行。
可能原因
当前连接设备异常。
处理步骤
重新连接设备再运行。
00401017 安装Hap包失败
错误信息
FileTransfer Failed: Error while Deploy Hap.
错误描述
安装Hap包失败。
可能原因
当前设备连接异常。
处理步骤
- 使用真机场景：请更换数据线或PC侧USB接口后尝试。
- 使用模拟器场景：
- 在Local Emulator的设备列表窗口，点击“Wipe User Data”清除数据，启动模拟器并重新运行工程。
- 打开命令行终端，并进入DevEco Studio安装目录下的sdk\default\openharmony\toolchains路径，执行`hdc kill -r`命令，启动模拟器，重新运行工程。
00401018 获取设备系统API版本失败
错误信息
Failed to get the device apiVersion.
错误描述
获取设备系统API版本失败。
可能原因
当前选择设备连接异常。
处理步骤
重新连接设备或者重启DevEco Studio。
00401019 工程配置的最低兼容API版本和设备API版本不匹配
错误信息
compatibleSdkVersion and releaseType of the app do not match the apiVersion and releaseType on the device.
错误描述
工程配置的最低兼容API版本和设备API版本不匹配。
可能原因
当前工程配置的最低兼容版本高于设备API版本。
处理步骤
使用命令`hdc shell param get const.ohos.apiversion`查询当前设备的API 版本，并对比工程级build-profile.json5文件中的compatibleSdkVersion字段。如果版本不匹配，可以使用以下解决办法：
方法一：请升级设备系统版本以匹配当前工程版本。在系统设置界面升级设备系统。
方法二：降低工程的API版本，点击DevEco Studio右上角的
，Compatible SDK选择更低的版本号，以兼容设备的API版本。
00401020 没有可用的端口号
错误信息
No port available.
错误描述
没有可用的端口号。
可能原因
当前电脑端口被管控或者端口号被占用。
处理步骤
- 排查是否有安全软件禁用端口，关闭端口管控。
- 重启电脑。
00401021 找不到可执行的ability
错误信息
No executable ability found.
错误描述
找不到可执行的ability。
可能原因
配置的ability不对，工程没同步成功。
处理步骤
重新同步工程。
00401022 本地HAP包不存在
错误信息
The local package does not exist.
错误描述
本地HAP包不存在。
可能原因
- 没有构建打包成功。
- 运行配置取消了构建任务，本地没有HAP包。
- 工程同步异常，没有生成构建需要的sync目录。
处理步骤
- 点击菜单栏Build > Clean Project清理缓存，再重新运行。
- 检查运行配置是否取消了构建任务，如果取消就重新添加构建任务。
- 点击菜单栏File > Sync and Refresh Project重新同步工程，等待同步成功后再运行。
00401023 hap包中config.json或module.json文件不存在
错误信息
The config.json or module.json file in the hap file does not exist.
错误描述
hap包中config.json或module.json文件不存在。
可能原因
编译构建生成的hap包不正确。
处理步骤
点击菜单栏Build > Clean Project清理缓存，再重新运行。
00401024 HAP文件数量超过100w
错误信息
Make sure the file count in the HAP does not exceed 1,000,000.
错误描述
HAP文件数量不要超过1,000,000。
可能原因
生成的HAP包里面文件数量超过了1,000,000，可能资源文件太多。
处理步骤
排查并精简工程资源文件再重新打包。
00401025 hap包中config.json或module.json文件内容为空
错误信息
The config.json or module.json file content is empty.
错误描述
hap包中config.json或module.json文件内容为空。
可能原因
编译构建生成的hap包不正确。
处理步骤
点击菜单栏Build > Clean Project清理缓存，再重新运行。
00401026 当前连接设备类型或apiVersion与工程配置不匹配
错误信息
The deviceType or apiVersion of the target device does not match that configured in the XXX file.
错误描述
当前连接设备的类型或apiVersion与工程配置不匹配。
可能原因
- 工程中config.json或module.json5文件配置的设备类型和当前选择的设备不匹配。
- 模块级build-profile.json5文件的apiVersion和当前选择的设备不匹配。
处理步骤
- 更换匹配的设备。
- 在config.json或module.json5文件增加当前连接的设备类型，模块级build-profile.json5文件的apiVersion增加当前设备对应的API。
00401027 当前连接设备为空
错误信息
The current device cannot be empty.
错误描述
当前连接设备为空。
可能原因
未连接设备，或设备连接异常。
处理步骤
重新连接设备再启动调试。
00401028 FA模型工程不支持DebugLine
错误信息
The FA model does not support the debugLine.
错误描述
FA模型工程不支持debugLine。
可能原因
FA工程模型不支持debugLine。
处理步骤
在运行/调试配置面板取消勾选Enable DebugLine。
00401029 获取SDK版本失败
错误信息
Failed to obtain the SDK version. Check whether the SDK is installed.
错误描述
获取SDK版本失败，检查SDK是否安装。
可能原因
未下载SDK或者用户自定义SDK配置有问题。
处理步骤
下载对应SDK或者重新配置自定义SDK。
00401030 SDK版本太低，不支持DebugLine
错误信息
The SDK version is too low to support DebugLine. Update it to 4.1.0.21 or a later version.
错误描述
SDK版本太低，不支持DebugLine，需要升级SDK版本到4.1.0.21及以上版本。
可能原因
当前SDK版本低于4.1.0.21版本。
处理步骤
在官网上重新下载DevEco Studio。
00401031 获取Hvigor版本失败
错误信息
Failed to obtain the Hvigor version.
错误描述
获取Hvigor版本失败。
可能原因
DevEco Studio中缺少hvigor工具。
处理步骤
检查DevEco Studio安装目录的tools目录下是否有hvigor工具，如果不存在，在官网上重新下载DevEco Studio。
00401032 Hvigor版本太低，不支持DebugLine
错误信息
The Hvigor version is too low to support DebugLine. Update it to 3.0.3-rc.1.s or a later version.
错误描述
Hvigor版本太低，不支持DebugLine，需要升级Hvigor版本到3.0.3-rc.1.s及以上版本。
可能原因
DevEco Studio版本太低。
处理步骤
在官网上重新下载DevEco Studio。
00401033 当前SDK版本不支持Tsan
错误信息
TSan is not supported by the current SDK version. Update the DevEco Studio to the latest version and make sure the API version of your project is 12 or later.
错误描述
当前SDK版本不支持Tsan，升级DevEco Studio到最新版本并且确保工程是API 12及以上版本。
可能原因
DevEco Studio版本太低或者工程低于API 12。
处理步骤
升级DevEco Studio到最新版本并且确保工程是API 12及以上版本。
00401034 主模块为空
错误信息
Main module is null.
错误描述
主模块为空。
可能原因
工程未同步成功。
处理步骤
点击菜单栏File > Sync and Refresh Project重新同步工程，确保工程同步成功后再运行工程。
00401035 当前设备不支持线程检测
错误信息
Thread Sanitizer is not supported on the target device. Disable this feature under Run > Edit Configurations > Diagnostics and try again. This feature is only available on phone,tablet,2in1,tv.
错误描述
当前连接设备不支持TSan检测，在运行配置中取消勾选TSan检测再重试。TSan检测仅支持phone、tablet、2in1、tv设备。
可能原因
当前连接设备类型不是phone、tablet、2in1、tv。
处理步骤
更换支持TSan检测的设备，或者点击Run > Edit Configurations > Diagnostics取消勾选Thread Sanitizer。
00401036 当前设备系统版本不支持TSan检测
错误信息
TSan is not supported on the current system version of the target device. Update the device system version to the latest version.
错误描述
当前设备系统版本不支持TSan检测，更新设备系统到最新版本。
可能原因
当前设备系统版本不支持TSan检测。
处理步骤
更新设备系统到最新版本。
00401037 当前选择的运行配置是热重载，不支持使用预览器运行/调试
错误信息
Cannot run or debug this module in Previewer while it has hot reload configured. Remove the hot reload configuration and try again.
错误描述
当前选择的运行配置是热重载，不支持使用预览器运行/调试，请重新选择运行配置再重试。
可能原因
当前选择的运行配置是热重载，不支持使用预览器运行/调试。
处理步骤
使用真机或模拟器运行/调试，或者重新选择运行配置在预览器运行/调试。
00401052 HAP包中配置文件超过10MB
错误信息
Make sure the module.json file in the HAP does not exceed 10 MB.
错误描述
确保HAP包中配置文件module.json不超过10MB。
可能原因
HAP包中module.json5配置文件超过10MB。
处理步骤
优化module.json5配置文件内容。
00401060 本地HAP包不存在
错误信息
Failed to open the file. The directory or file does not exist.
错误描述
本地HAP包不存在。
可能原因
HAP包不存在，检查签名HAP包是否打包成功。
处理步骤
确保签名HAP包打包成功后再运行，签名请参考配置调试签名。
00401061 权限不足无法访问HAP包所在路径
错误信息
Failed to open the file. The current directory is not accessible due to insufficient permissions.
错误描述
推包失败，权限不足无法访问HAP包所在路径。
可能原因
权限不足无法访问HAP包所在路径。
处理步骤
Windows系统建议将工程移出C盘，MAC系统设置DevEco Studio获取完全磁盘访问权限，然后重新运行。