脚本错误码
00302001 FA模型不支持单元测试
错误信息FA mode does not support unit test.
错误描述FA模型不支持单元测试。
可能原因在FA模型工程上，使用命令行的方式执行了单元测试。
处理步骤不要对FA模型工程执行单元测试。
00302002 初始化模块时找不到插件
错误信息The XXX plugin was not found when initializing the YYY module
错误描述初始化模块时找不到XXX插件。
可能原因module.json5文件中的module.type字段与hvigorfile.ts文件中导出的系统插件不一致。
处理步骤确保模块下module.json5文件的module.type字段和hvigorfile.ts文件中导出的系统插件一致。
00302013 根节点还没准备好用于构建
错误信息The root node is not yet available for build.
错误描述根节点还没准备好用于构建。
可能原因在hvigorconfig.ts中调用API，该文件的执行时机比nodesInitialized更早，导致API 调用失败。
处理步骤在hvigorfile.ts中调用API，确保符合Hvigor生命周期的执行顺序。
00302014 hvigorConfig还没准备好用于构建
错误信息The hvigorConfig is not yet available for build.
错误描述hvigorConfig还没准备好用于构建。
可能原因未知。
处理步骤通过在线提单提交问题，华为支持人员会及时处理。
00302015 调用内部hook函数时出现异常
错误信息XXX in hvigorfile at XXX.
错误描述调用内部hook函数时出现异常。
可能原因执行节点内部的hook函数时出现异常。
处理步骤参考扩展API文档，确保调用的API正确。
00302016 Stage模型工程hvigorfile缺少系统插件
错误信息Invalid exports, no system plugins were found in hvigorfile: XXX.
错误描述导出无效，在hvigorfile中找不到系统插件。
可能原因- hvigorfile.ts中system字段缺失。
- hvigorfile.ts中使用的appTasks/hapTasks/hspTasks/harTasks不存在。
- hvigorfile.ts文件没有使用export default进行导出。
- 确保hvigorfile.ts中system字段存在。
- 工程级hvigorfile.ts对应的插件为appTasks，模块级hvigorfile.ts对应的插件为hapTasks/hspTasks/harTasks。
- 确保hvigorfile.ts中使用export default进行导出。
示例如下：
export default {
system: appTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
plugins:[] /* Custom plugin to extend the functionality of Hvigor. */
}
00302017 命令行中有未知的模块名
错误信息Unknown module XXX in the command line.
错误描述命令行中有未知模块XXX。
可能原因命令行中的模块名在hvigorconfig.ts文件中被动态删除。
处理步骤确保模块在hvigorconfig.ts文件中没有被删除。
00302018 命令行中有未知的模块名
错误信息Unknown module XXX in the command line.
错误描述命令行中有未知模块XXX。
可能原因命令行中的模块名在工程级build-profile.json5文件中不存在。
处理步骤确保模块在工程级build-profile.json5文件的modules字段中已设置。
00302019 自定义插件返回值类型不正确
错误信息File XXX exports an invalid plugin XXX with invalid order return XXX. Must return a number value.
错误描述自定义插件返回值类型不正确。
可能原因文件XXX导出的插件返回值类型不正确。
处理步骤确保导出的插件返回值类型是数值。
00302020 自定义插件名字重复
错误信息File XXX exports an invalid plugin XXX whose name XXX duplicate with other plugins. Please rename this plugin.
错误描述自定义插件名字重复。
可能原因自定义插件里有重复的名字。
处理步骤检查自定义的hvigor插件是否存在重复的名字。
00302021 自定义插件没有默认导出
错误信息File XXX has no default export.
错误描述自定义插件没有默认导出。
可能原因hvigor自定义插件没有default导出。
处理步骤将文件XXX中定义的hvigor插件default导出。
00302022 导出未定义的插件
错误信息File XXX exports an undefined plugin.
错误描述导出了未定义的插件。
可能原因文件XXX导出了未定义的hvigor插件。
处理步骤确保导出正确的hvigor插件。
00302023 自定义插件类型不正确
错误信息File XXX exports an invalid plugin with type XXX.
错误描述自定义插件类型不正确。
可能原因文件XXX导出的插件类型不正确。
处理步骤检查导出的插件类型，确保是object。
00302024 自定义插件名称不存在
错误信息File XXX exports an invalid plugin without a name.
错误描述文件导出了一个没有名称的插件。
可能原因文件XXX导出的插件没有名称。
处理步骤确保导出的插件名称存在。
00302025 自定义插件名称类型不正确
错误信息File XXX exports an invalid plugin whose name is not a string.
错误描述文件导出了一个名称不是字符串的插件。
可能原因文件XXX导出的插件名称不是字符串类型。
处理步骤确保导出的插件名称是字符串类型。
00302026 自定义插件的执行顺序不正确
错误信息File XXX exports an invalid plugin YYY with unknown order ZZZ.
错误描述文件导出了一个执行顺序未知的插件。
可能原因文件XXX导出的插件的执行顺序未知。
处理步骤确保导出的插件具有正确的执行顺序。
00302027 自定义插件的hook类型不正确
错误信息File XXX exports an invalid plugin YYY whose hook ZZZ is not a function.
错误描述文件导出了一个hook不是函数的插件。
可能原因文件XXX导出的插件YYY的hook ZZZ不是函数。
处理步骤确保导出的插件正确定义了hook，并且类型是函数。
00302029 插件与模块类型不匹配
错误信息The plugin referenced in the hvigorfile does not match moduleType in the module.json5/config.json file.
错误描述hvigorfile中引用的插件与module.json5/config.json文件中的模块类型不一致。
可能原因hvigorfile注册的任务类型（如hapTasks）与模块类型（如HAR模块）不一致，比如hap模块引用了harPlugin。
处理步骤确保任务类型和模块类型保持一致。
00302030 API类型不匹配
错误信息Mismatch with apiType at 'XXX'.
错误描述XXX处的apiType配置不匹配。
可能原因模块级hvigorfile.ts和模块级build-profile.json5中的apiType不一致。
处理步骤确保apiType配置一致。
00302031 FA模型工程hvigorfile缺少系统插件
错误信息Invalid exports, no system plugins were found in hvigorfile. At file: XXX.
错误描述导出无效，在hvigorfile中找不到系统插件。
可能原因- hvigorfile.ts中system字段缺失。
- hvigorfile.ts中使用的legacyAppTasks/legacyHapTasks/legacyHarTasks不存在。
- hvigorfile.ts文件没有使用export default进行导出。
- 确保hvigorfile.ts中system字段存在。
- 工程级hvigorfile.ts对应的插件为legacyAppTasks，模块级hvigorfile.ts对应的插件为legacyHapTasks/legacyHarTasks。
- 确保hvigorfile.ts中使用export default进行导出。
示例如下：
export default {
system: legacyAppTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
plugins:[] /* Custom plugin to extend the functionality of Hvigor. */
}
00302032 Stage模型工程hvigorfile缺少系统插件
错误信息Invalid exports, no system plugins were found in hvigorfile.
错误描述导出无效，在hvigorfile中找不到系统插件。
可能原因- hvigorfile.ts中system字段缺失。
- hvigorfile.ts中使用的appTasks/hapTasks/hspTasks/harTasks不存在。
- hvigorfile.ts文件没有使用export default进行导出。
- 确保hvigorfile.ts中system字段存在。
- 工程级hvigorfile.ts对应的插件为appTasks，模块级hvigorfile.ts对应的插件为hapTasks/hspTasks/harTasks。
- 确保hvigorfile.ts中使用export default进行导出。
示例如下：
export default {
system: appTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
plugins:[] /* Custom plugin to extend the functionality of Hvigor. */
}
00302033 hvigorfile.ts中的setProperty方法校验失败
错误信息Method setProperty validate failed in hvigorfile.ts.
错误描述hvigorfile.ts中的setProperty方法校验失败。
可能原因在hvigorfile.ts中使用setProperty方法传入参数不符合schema校验。
处理步骤请按照报错提示信息，修改hvigorfile.ts文件中的字段。
00302034 生命周期XXX执行失败
错误信息Failed to execute hook 'XXX': YYY.
错误描述生命周期XXX执行失败。
可能原因生命周期XXX中的代码执行报错。
处理步骤- 根据报错信息YYY检查生命周期XXX中的代码。
- 将hvigor-config.json5中的stacktrace字段设置为true，根据堆栈信息排查。
00302035 自定义插件YYY的函数XXX执行失败
错误信息Failed to execute function 'XXX' of the custom plugin whose pluginId is 'YYY': ZZZ.
错误描述自定义插件YYY的函数XXX执行失败。
可能原因自定义插件YYY的函数XXX中的代码执行报错。
处理步骤- 根据报错信息ZZZ检查自定义插件YYY的函数XXX中的代码。
- 将hvigor-config.json5中的stacktrace字段设置为true，根据堆栈信息排查。
00302036 生命周期XXX执行失败
错误信息Failed to execute node hook 'XXX': YYY.
错误描述生命周期XXX执行失败。
可能原因生命周期XXX中的代码执行报错。
处理步骤- 根据报错信息YYY检查生命周期XXX中的代码。
- 将hvigor-config.json5中的stacktrace字段设置为true，根据堆栈信息排查。
00302037 hvigorfile.ts文件YYY执行失败
错误信息Failed to load or execute hvigorfile.ts: XXX At file: YYY.
错误描述hvigorfile.ts文件YYY执行失败。
可能原因hvigorfile.ts文件YYY的代码执行报错。
处理步骤- 根据报错信息XXX检查hvigorfile.ts文件YYY的代码。
- 将hvigor-config.json5中的stacktrace字段设置为true，根据堆栈信息排查。
00302039 hvigorfile.ts中找不到模块
错误信息Failed to load or execute hvigorfile.ts: XXX. At file: YYY。
错误描述hvigorfile.ts脚本执行失败，依赖导入失败。
可能原因- 构建依赖的插件没有在hvigor-config.json5的dependencies中配置。
- 在hvigor-config.json5的dependencies中配置了依赖的插件，并且sync后提示对应依赖安装成功，使用时仍然报错，该场景可能是pnpm工具问题导致显示安装成功实际安装失败。
- 在hvigor-config.json5的dependencies中配置依赖的插件，并且执行sync安装依赖。
- 如果提示安装依赖成功后仍报错，按以下步骤处理：
- 修改“用户目录/.hvigor/wrapper/tools/package.json”中的pnpm版本为"10.16.1"（注意不要带^符号）。
- 在Terminal中进入“用户目录/.hvigor/wrapper/tools”目录，执行命令"npm install"。
- 删除“用户目录/.hvigor/project_caches”缓存目录。