# 热重载和增量调试错误码

#### 00402001 找不到SDK

**错误信息**

Install the SDK first.

**错误描述**

请先安装SDK。

**可能原因**

找不到SDK。

**处理步骤**

检查DevEco Studio安装目录下sdk/default/openharmony路径下面是否有ets目录，如果不存在，在官网上重新下载DevEco Studio。

#### 00402002 热重载只支持STAGE模型工程

**错误信息**

Hot Reload Feature is only supported in STAGE and esmodule project.

**错误描述**

热重载仅支持Stage模型工程。

**可能原因**

当前工程不是Stage模型工程。

**处理步骤**

请使用Stage模型工程，或者选择非热重载运行配置。

#### 00402003 热重载模式启动时，找不到node路径

**错误信息**

The nodejs path configured for the project is invalid or not found.

**错误描述**

找不到node路径。

**可能原因**

node路径不存在。

**处理步骤**

检查DevEco Studio安装目录的tools目录下是否存在node工具，如果不存在，在官网上重新下载DevEco Studio。

#### 00402004 当前修改不支持热重载

**错误信息**

The current modification does not support hot reload. Please reinstall and restart.

**错误描述**

当前修改不支持热重载。

**可能原因**

当前的代码修改场景不支持热重载。

**处理步骤**

请根据当前热重载的使用约束检查当前修改是否支持，如果不支持，需要先点击运行或调试后，再重新启动热重载。

#### 00402005 热重载仅支持文件修改，不支持文件的新增或删除

**错误信息**

Hot reload is supported only for file change, but not file addition and deletion.

**错误描述**

热重载仅支持文件修改，不支持文件的新增或删除。

**可能原因**

在热重载模式运行期间，用户进行了文件的新增或删除。

**处理步骤**

先点击运行或调试后，再重新启动热重载。

#### 00402006 进行文件对比时，无法获取node路径

**错误信息**

The nodejs path configured in the IDE is invalid or not found.

**错误描述**

找不到node路径。

**可能原因**

进行文件对比时，无法获取node路径。

**处理步骤**

检查DevEco Studio安装目录的tools目录下是否存在node工具，如果不存在，在官网上重新下载DevEco Studio。

#### 00402007 热重载运行超时

**错误信息**

Execute hot-reload timeout, please reinstall and restart.

**错误描述**

热重载运行超时，请重启热重载。

**可能原因**

热重载进行quickfix时超时。

**处理步骤**

先点击运行或调试后，再重新启动热重载。

#### 00402008 热重载构建失败

**错误信息**

Build failed, check the error information in the console, rectify the fault, and try again.

**错误描述**

构建失败，请检查控制台中的错误信息，排除故障后重试。

**可能原因**

构建失败。

**处理步骤**

根据控制台中的错误信息进行处理后重试。

#### 00402009 增量包签名失败

**错误信息**

Failed to sign the patch package, please check the signingConfigs in build-profile.json5.

**错误描述**

增量包签名失败，请检查build-profile.json5文件中的signingConfigs签名配置是否正确。

**可能原因**

签名配置不正确。

**处理步骤**

请检查build-profile.json5文件中的signingConfigs签名配置是否正确，如果不正确，重新签名后重试。

#### 00402010 构建未生成补丁abc文件

**错误信息**

PatchAbc was not generated, please clean and restart project.

**错误描述**

补丁abc文件未生成，请清理缓存后重试。

**可能原因**

构建生成补丁abc文件失败。

**处理步骤**

点击菜单栏**Build > Clean Project**清理缓存后重试。

#### 00402011 hqf增量包生成失败

**错误信息**

Failed to create the patch package, please clean and restart project.

**错误描述**

hqf增量包生成失败，请清理缓存后重试。

**可能原因**

构建生成hqf增量包失败。

**处理步骤**

点击菜单栏**Build > Clean Project**清理缓存后重试。

#### 00402012 重新加载文件失败

**错误信息**

Reloaded XXX files failed. Please reinstall and restart.

**错误描述**

重新加载文件失败，请重新安装并重启。

**可能原因**

热重载执行bm quickfix命令失败。

**处理步骤**

可检查以下几方面：

1.  检查工程签名是否正确，热重载需要使用调试证书签名，不支持使用发布证书签名，具体参考配置调试签名。
2.  检查工程的构建模式，热重载需要使用debug模式，不支持release模式，具体参考指定构建模式。

#### 00402013 执行Apply Changes超时

**错误信息**

Execute apply-change timeout, please restart and reinstall.

**错误描述**

执行Apply Changes超时，请重启并重新安装。

**可能原因**

Apply Changes时执行hdc命令超时，可能hdc异常或者设备连接异常。

**处理步骤**

拔插设备，或者执行hdc kill -r重启hdc后再重试。

#### 00402014 构建hqf增量包失败

**错误信息**

Build failed, please reinstall and restart.

**错误描述**

构建失败，请重新安装并重启。

**可能原因**

构建hqf增量包失败，详细信息查看构建控制台。

**处理步骤**

查看构建控制台，根据提示信息修改完成后重试。

#### 00402015 预览器不支持Apply Change

**错误信息**

Apply Changes not supported when device type is Previewer.

**错误描述**

预览器不支持Apply Changes。

**可能原因**

设备为预览器时使用Apply Changes。

**处理步骤**

预览器不支持Apply Changes，如需使用Apply Changes功能，请切换真机或模拟器。

#### 00402016 请先启动或调试项目

**错误信息**

Start or debug the project first.

**错误描述**

请先启动或调试项目。

**可能原因**

没有先启动或调试项目，就尝试执行Apply Changes。

**处理步骤**

请先点击Run/Debug按钮启动或调试项目，修改代码后再执行Apply Changes。

#### 00402017 HSP模块不支持Apply Changes

**错误信息**

Apply Changes not supported for shared modules.

**错误描述**

HSP模块不支持Apply Changes。

**可能原因**

当前是HSP模块，不支持Apply Changes。

**处理步骤**

重新选择HAP模块再重试。

#### 00402018 FA模型的项目不支持Apply Changes

**错误信息**

Apply Changes not supported for projects in the FA model.

**错误描述**

FA模型的项目不支持Apply Changes。

**可能原因**

当前是FA模型的项目，不支持Apply Changes。

**处理步骤**

FA模型的项目不要使用Apply Changes。

#### 00402019 当启动模块设置为Nothing时不支持Apply Changes

**错误信息**

Apply Changes not supported when Launch module is set to Nothing.

**错误描述**

当启动模块设置为Nothing时不支持Apply Changes。

**可能原因**

运行/调试配置面板中的Launch Options配置的Launch是Nothing。

**处理步骤**

运行/调试配置面板中，Launch Options下的Launch选择一个ability再重试。

#### 00402020 当前运行配置为空

**错误信息**

XXX: settings is null.

**错误描述**

当前运行配置为空。

**可能原因**

没有选择运行配置。

**处理步骤**

重新选择运行配置。

#### 00402021 未检测到C++文件或资源文件的更改

**错误信息**

No changes detected on C++ files or resource files. If you have made changes to files in other types, click the Run/Debug icon instead.

**错误描述**

未检测到C++文件或资源文件的更改。如果对其他类型的文件进行了更改，请点击运行/调试按钮。

**可能原因**

没有修改C++文件或者资源文件，修改了ETS文件或者没有任何修改。

**处理步骤**

修改C++文件或者资源文件再执行Apply Change，如果修改其他类型的文件，请点击运行/调试按钮。

#### 00402024 未能成功在设备上部署增量更改

**错误信息**

Failed to deploy the incremental changes on the device. Update the device image to the latest version and try again, or click the Run/Debug icon to deploy all changes.

**错误描述**

未能在设备上部署增量更改。请将设备镜像更新至最新版本后重试，或点击运行/调试按钮以部署所有更改。

**可能原因**

1.  执行bm quickfix命令失败，可能设备镜像版本比较低。
2.  如果是2in1设备，可能是应用开启了应用加速服务。

**处理步骤**

1.  请将设备镜像更新至最新版本后重试，或点击运行/调试按钮。
2.  如果是2in1设备，请在设备的**设置 > 应用和元服务 > 应用加速服务**中，查看应用是否开启了应用加速服务，并关闭应用的加速服务。

#### 00402025 hqf和hap的ASan/TSan/UBSan/HWASan不一致

**错误信息**

Apply change fail, please confirm whether ASan/TSan/UBSan/HWASan is same as the hap and reinstall.

**错误描述**

执行Apply change失败，请确认ASan/TSan/UBSan/HWASan是否与hap相同，并重新安装。

**可能原因**

ASan、TSan、UBSan、HWASan不能同时开启，四个只能开启其中一个。

**处理步骤**

设置ASan/TSan/UBSan/HWASan和hap一致，或者卸载应用再重新运行。

#### 00402026 执行Apply change失败

**错误信息**

Apply change fail.

**错误描述**

执行Apply change失败。

**可能原因**

设备连接异常或者hdc异常。

**处理步骤**

重新拔插设备，或者执行hdc kill -r再重试。

#### 00402027 设备处于锁屏状态

**错误信息**

The screen is locked. Please unlock the screen and try again.

**错误描述**

设备处于锁屏状态。请解锁屏幕并重试。

**可能原因**

应用启动或Apply Changes时设备处于锁屏状态。

**处理步骤**

请解锁屏幕并重试。

#### 00402028 应用启动时ability不可见

**错误信息**

Ability is not visible.

**错误描述**

Ability不可见。

**可能原因**

当前aa start命令启动的Ability不可见。

**处理步骤**

*   Stage模型工程：在module.json5文件中，将abilities字段下的exported设置为true。
*   FA模型工程：在config.json文件中，将abilities字段下的visible设置为true。

#### 00402030 无法创建changedFileList.json文件

**错误信息**

Failed to create changedFileList.json, please clean and restart project.

**错误描述**

无法创建changedFileList.json文件，请清理并重启项目。

**可能原因**

创建changedFileList.json文件失败。

**处理步骤**

点击菜单栏**Build > Clean Project**清理缓存后重试。

#### 00402031 无法获取用于文件比较的node脚本

**错误信息**

Failed to obtain the node script for file comparison. Please reinstall the IDE.

**错误描述**

无法获取用于文件比较的node脚本。请重新安装IDE。

**可能原因**

无法获取用于文件比较的node脚本。

**处理步骤**

重新下载安装DevEco Studio。

#### 00402032 以下更改无法进行热重载和热重启

**错误信息**

Hot reload and hot restart unavailable for the following changes.

**错误描述**

以下更改无法进行热重载和热重启。

**可能原因**

控制台提示的是热重载和热重启都不支持的场景。

**处理步骤**

请根据当前热重载和热重启的使用约束检查当前修改是否支持，如果不支持，需要先点击运行或调试后，再重新启动热重载或热重启。

#### 00402033 ChangedFileList.json为空或不存在

**错误信息**

ChangedFileList.json is null or empty, please clean and rerun project.

**错误描述**

ChangedFileList.json为空或不存在，请清理并重新运行项目。

**可能原因**

ChangedFileList.json为空或不存在。

**处理步骤**

点击菜单栏**Build > Clean Project**清理缓存后重试。

#### 00402034 以下更改无法进行热重载

**错误信息**

Hot reload unavailable for the following changes.

**错误描述**

以下更改无法进行热重载。

**可能原因**

触发了热重载不支持、热重启支持的场景，但是没勾选**Enable hot restart**。

**处理步骤**

打开热重启开关后，点击运行或调试，再重新启动热重载。

#### 00402035 release模式下不支持热重载

**错误信息**

Cannot hot reload the project when its build mode is release. Change the build mode to debug and try again.

**错误描述**

当构建模式为release模式时，无法热重载项目。请将构建模式更改为debug模式后重试。

**可能原因**

当前项目的构建模式为release模式。

**处理步骤**

请将构建模式更改为debug模式后重试。

#### 00402036 hdc版本不兼容

**错误信息**

Incompatible hdc version. Use the one in sdk\\default\\openharmony\\toolchains under the DevEco Studio installation directory.

**错误描述**

hdc版本不兼容。请使用DevEco Studio安装目录下sdk\\default\\openharmony\\toolchains下的hdc。

**可能原因**

环境变量配置了较低版本的hdc。

**处理步骤**

hdc环境变量更新为DevEco Studio安装目录下sdk\\default\\openharmony\\toolchains下的hdc，再重启DevEco Studio。