# 规格错误码

#### 00306001 文件路径长度超过最大限制

**错误信息**

The length of path exceeds the maximum length: XXX.

**错误描述**

文件路径长度超过最大限制。

**可能原因**

文件路径总长度超过了操作系统的限制。

**处理步骤**

1.  缩短工程根路径。
2.  简化工程名称。
3.  简化模块名称。
4.  简化target名称。

#### 00306002 工程路径不能包含中文字符

**错误信息**

The Node directory and node name cannot contain Chinese characters.

**错误描述**

工程路径不能包含中文字符。

**可能原因**

工程路径存在中文字符。

**处理步骤**

移除工程路径中的中文字符。

#### 00306003 工程路径无效

**错误信息**

Invalid project path. Current path does not match: XXX.

**错误描述**

工程路径无效。

**可能原因**

工程路径存在中文或特殊字符。

**处理步骤**

修改工程路径，确保路径只包含字母、数字、连字符-、下划线\_、点号.、英文括号()、空格或@符号。

#### 00306004 不支持的API版本

**错误信息**

The compatibleSDKVersion XXX cannot be smaller than YYY declared in library ZZZ或

The project's compatibleSdkVersion: XXX cannot be lower than the minimum compatible version YYY required by the dependencies: ZZZ.

**错误描述**

当前项目的compatibleSdkVersion版本号不能小于三方库ZZZ的最低兼容版本YYY。

**可能原因**

项目的compatibleSdkVersion版本小于三方库中打包时声明的compatibleSdkVersion版本（最低兼容版本）。

**处理步骤**

采用以下任意一种方式：

*   尝试更新当前项目的compatibleSdkVersion版本，使其大于或等于三方库中声明的版本。
*   降低三方库的compatibleSdkVersion，在打包前修改工程级build-profile.json5中的compatibleSdkVersion，使其兼容更低版本。
*   移除与项目的compatibleSdkVersion版本不兼容的三方库，或者使用版本更低的三方库。

#### 00306005 output名称重复

**错误信息**

Failed to build the app due to duplicate customized output names: XXX. At file: XXX.

**错误描述**

自定义的output名称重复，导致构建应用失败。

**可能原因**

模块的target配置中，自定义的output名称重复。

**处理步骤**

检查模块级build-profile.json5文件的targets配置，确保每个output名称都是唯一的。

#### 00306006 API 12及以上支持TargetESVersion

**错误信息**

Unsupported API version. TargetESVersion is supported after API 12. At file: XXX.

**错误描述**

TargetESVersion在API 12及以上版本中支持，当前项目的API版本低于此要求。

**可能原因**

当前项目的compileSdkVersion或compatibleSdkVersion低于API 12。

**处理步骤**

检查工程级build-profile.json5文件中的compileSdkVersion和compatibleSdkVersion配置，确保其版本为API 12或以上。

#### 00306007 意图框架工程的runtimeOS只能配置为HarmonyOS

**错误信息**

The runtimeOS that supports the insightintent project can only be HarmonyOS. At file: XXX.

**错误描述**

意图框架工程的runtimeOS只能配置为HarmonyOS。

**可能原因**

意图框架工程的runtimeOS没有配置为HarmonyOS。

**处理步骤**

检查工程级或模块级build-profile.json5文件，确保runtimeOS设置为HarmonyOS。

#### 00306008 API 版本不支持意图框架

**错误信息**

Unsupported API version. Insight intent is supported after API 11. At file: XXX.

**错误描述**

API 11及以上工程支持意图框架。

**可能原因**

当前项目的compileSdkVersion或compatibleSdkVersion低于API 11。

**处理步骤**

检查工程级build-profile.json5文件中的compileSdkVersion和compatibleSdkVersion配置，确保其版本为API 11或以上。

#### 00306009 SDK版本不支持意图框架

**错误信息**

Unsupported SDK version. Insight intent is supported after API 11. At file: XXX.

**错误描述**

API 11及以上工程支持意图框架。

**可能原因**

当前使用的SDK版本低于API 11。

**处理步骤**

在官网上下载新版本的DevEco Studio。

#### 00306010 SDK版本不支持ArkData

**错误信息**

The current SDK version does not support ArkData. At file: XXX.

**错误描述**

当前SDK版本不支持ArkData功能。

**可能原因**

当前使用的SDK版本不支持ArkData功能。

**处理步骤**

在官网上下载新版本的DevEco Studio。

#### 00306011 SDK版本不支持UI语法

**错误信息**

The current SDK version does not support uiSyntax. At file: XXX.

**错误描述**

当前SDK版本不支持UI语法。

**可能原因**

当前使用的SDK版本不支持UI语法。

**处理步骤**

在官网上下载新版本的DevEco Studio。

#### 00306012 不支持动态导入

**错误信息**

Invalid configuration of runtimeOnly in XXX. At file: XXX.

**错误描述**

runtimeOnly配置无效，不支持动态导入。

**可能原因**

仅API 11及以上的Stage模型工程支持配置runtimeOnly。

**处理步骤**

1.  确保工程级build-profile.json5中的compatibleSdkVersion版本为11或以上。
2.  确保模块级build-profile.json5中的apiType为stageMode。

#### 00306013 Stage模型的OpenHarmony工程不支持元服务开发

**错误信息**

Atomic service development is not supported for OpenHarmony stage model. At file: XXX

**错误描述**

Stage模型的OpenHarmony工程不支持元服务开发。

**可能原因**

元服务工程的runtimeOS配置为OpenHarmony。

**处理步骤**

如需开发元服务，请将工程级build-profile.json5中的runtimeOS改为HarmonyOS。

#### 00306014 API版本不支持元服务开发

**错误信息**

Atomic service development is not supported for compileSdkVersion/compatibleSdkVersion less than api 11. At file: XXX.

**错误描述**

compileSdkVersion或compatibleSdkVersion低于API 11时不支持元服务开发。

**可能原因**

当前工程的compileSdkVersion或compatibleSdkVersion低于API 11，不支持元服务开发。

**处理步骤**

检查工程级build-profile.json5文件的compileSdkVersion和compatibleSdkVersion配置，确保其版本为API 11或以上。

#### 00306015 元服务不支持Native开发

**错误信息**

Atomic service development does not support Native development. At file: XXX.

**错误描述**

元服务不支持Native开发。

**可能原因**

当前工程XXX文件中包含了与Native开发相关的选项：externalNativeOptions。

**处理步骤**

确保元服务工程中不包含externalNativeOptions。

#### 00306016 元服务开发仅支持ArkTS

**错误信息**

Atomic service development only supported arkTS widget. At file: XXX.

**错误描述**

元服务开发仅支持ArkTS组件。

**可能原因**

工程中使用了JS组件。

**处理步骤**

从工程中移除与JS组件相关的代码和配置。

#### 00306017 API版本不支持集成态HSP

**错误信息**

The integratedHsp can only be used in API 12 and later. At file: XXX.

**错误描述**

API 12及以上版本支持使用集成态HSP。

**可能原因**

当前工程的compileSdkVersion或compatibleSdkVersion低于API 12。

**处理步骤**

检查工程级build-profile.json5的compileSdkVersion和compatibleSdkVersion配置，确保版本为API 12或以上。

#### 00306018 使用集成态HSP需要将useNormalizedOHMUrl设置为true

**错误信息**

The integratedHsp is available only when useNormalizedOHMUrl is set to true. At file: XXX.

**错误描述**

使用集成态HSP需要将useNormalizedOHMUrl设置为true。

**可能原因**

useNormalizedOHMUrl设置为false。

**处理步骤**

检查工程级build-profile.json5的useNormalizedOHMUrl配置，确保设置为true。

#### 00306019 仅字节码HAR支持配置bundledDependencies

**错误信息**

Only the byte code har supports to configure the bundledDependencies. At file: XXX.

**错误描述**

仅字节码HAR支持配置bundledDependencies。

**可能原因**

1.  工程级build-profile.json5的buildOption.strictMode下未配置useNormalizedOHMUrl，或者该属性值设置为false。
2.  在模块级build-profile.json5文件中，buildOption.arkOptions.byteCodeHar设置为false。

**处理步骤**

1.  确保工程级build-profile.json5的buildOption.strictMode包含useNormalizedOHMUrl属性，并将其设置为true。
2.  确保模块级build-profile.json5文件中，buildOption.arkOptions.byteCodeHar设置为true。

#### 00306026 LiteWearable穿戴类型只支持JS开发

**错误信息**

Lite wearable only support JS.

**错误描述**

LiteWearable穿戴类型只支持JS开发。

**可能原因**

在LiteWearable穿戴类型的项目中存在TS文件。

**处理步骤**

确保项目中只包含JS文件。

#### 00306027 依赖模块不支持设备类型

**错误信息**

The XXX module YYY that the current module depends on does not support the device type: ZZZ, which may cause runtime exception on the device.

**错误描述**

当前模块依赖的YYY模块不支持设备类型ZZZ，可能会导致运行时异常。

**可能原因**

依赖模块的module.json中缺少该设备类型。

**处理步骤**

更新依赖模块，选择支持该设备类型的模块作为依赖。

#### 00306030 transformLib不是相对路径

**错误信息**

Invalid transformLib, its value should be a relative path.

**错误描述**

无效的transformLib，该值应该是相对路径。

**可能原因**

配置的transformLib不是相对路径。

**处理步骤**

确保transformLib是相对路径。

#### 00306034 buildRoot参数无效

**错误信息**

Invalid buildRoot value XXX.

**错误描述**

buildRoot参数无效。

**可能原因**

执行hvigorw命令时，指定的buildRoot参数..开头。

**处理步骤**

确保buildRoot参数对应的目录在当前模块下，即不允许以..开头。

#### 00306035 未知的abiFilter

**错误信息**

Unknown abiFilter XXX.

**错误描述**

未知的abiFilter配置XXX。

**可能原因**

配置的abiFilter不在支持的列表中或者拼写错误。

**处理步骤**

检查工程级或模块级build-profile.json5文件，确保abiFilters只包含以下值：arm64-v8a、x86\_64。

#### 00306036 ohosTest不支持作为构建HSP/HAR的target

**错误信息**

Hvigor task 'XXX' not supported for building an 'ohosTest' target 'YYY'.

**错误描述**

构建HSP/HAR时，不支持选择ohosTest作为target。

**可能原因**

通过命令行构建HSP/HAR时，选择ohosTest作为target。

**处理步骤**

*   选择其他target构建HAR/HSP。
*   构建HAP模块时支持使用ohosTest作为target。

#### 00306038 Stage模型的模块不允许依赖FA模型的模块

**错误信息**

Stage model module XXX does not allow Harmony library packages or modules in FA model. Build tasks will not be executed, and resources will not be packed.

**错误描述**

XXX为Stage模型模块，不能依赖FA模型的Harmony库或模块，否则会导致构建任务无法执行，资源无法打包。

**可能原因**

Stage模型的模块依赖了FA模型的库或模块。

**处理步骤**

检查XXX的依赖关系，确保没有引用FA模型的Harmony库或模块。

#### 00306039 HSP不能依赖本模块

**错误信息**

Shared Library cannot depend on shared module self in module XXX at file: YYY.

**错误描述**

在XXX模块中，HSP（共享库）不能依赖本模块。

**可能原因**

HSP模块依赖了自身。

**处理步骤**

移除HSP的自身依赖。

#### 00306040 FA模型模块不允许依赖非源码OpenHarmony npm包

**错误信息**

FA module XXX does not allow OpenHarmony npm packages, which artifactType is not original. Check at file: YYY.

**错误描述**

FA模型模块不允许依赖非源码OpenHarmony npm包。

**可能原因**

XXX模块依赖的OpenHarmony npm包是字节码或混淆的源码。

**处理步骤**

移除XXX模块对非源码OpenHarmony npm包的依赖。

#### 00306041 FA模型的模块不允许依赖Stage模型的模块

**错误信息**

FA model module XXX does not allow Harmony library packages or modules in Stage model. Build tasks will not be executed, and resources will not be packed. Check at file: YYY.

**错误描述**

XXX为FA模型模块，不能依赖Stage模型的Harmony库或模块，否则会导致构建任务无法执行，资源无法打包。

**可能原因**

FA模型的模块依赖了Stage模型的库或模块。

**处理步骤**

检查XXX的依赖关系，确保没有引用Stage模型的Harmony库或模块。

#### 00306042 API版本格式错误

**错误信息**

In HarmonyOS configuration:

\- For API versions 10 to 25, the value of compatibleSdkVersion/targetSdkVersion must be a string (for example, '5.0.0(12)').

\- For API version 26 and later, the value of compatibleSdkVersion/targetSdkVersion must be a string (for example, '26.0.0').

In OpenHarmony configuration:

\- For API versions 10 to 25, the value of compileSdkVersion/compatibleSdkVersion/targetSdkVersion must be a numeric value (for example, 12).

\- For API version 26 and later, the value of compileSdkVersion/compatibleSdkVersion/targetSdkVersion must be a string (for example,'26.0.0').

**错误描述**

在HarmonyOS配置中：

*   当API版本为10~25时，compatibleSdkVersion/targetSdkVersion是字符串类型，例如 '5.0.0(12)'。
*   当API版本为26及以上时，compatibleSdkVersion/targetSdkVersion是字符串类型，例如'26.0.0'。

在OpenHarmony配置中：

*   当API版本为10~25时，compileSdkVersion/compatibleSdkVersion/targetSdkVersion是数值类型，例如12。
*   当API版本为26及以上时，compileSdkVersion/compatibleSdkVersion/targetSdkVersion是字符串类型，例如'26.0.0'。

**可能原因**

compileSdkVersion/compatibleSdkVersion/targetSdkVersion字段的值类型不符合要求。

**处理步骤**

检查工程级build-profile.json5文件，确保以上字段的值类型符合要求。

#### 00306043 JS模块不允许依赖ArkTS库

**错误信息**

JS module XXX does not allow ArkTS dependency YYY. Check at file: ZZZ.

**错误描述**

JS模块XXX不能依赖ArkTS YYY。

**可能原因**

JS模块引入了ArkTS依赖YYY。

**处理步骤**

检查XXX模块oh-package.json5的依赖项，确保其不包含ArkTS依赖YYY。

#### 00306044 JS堆内存不足

**错误信息**

Worker terminated due to reaching memory limit: JS heap out of memory.

**错误描述**

达到内存限制导致任务终止：JS堆内存不足。

**可能原因**

任务执行过程中堆内存不足。

**处理步骤**

1.  在hvigor-config.json5中调整线程相关配置：hvigor.pool.maxSize、ohos.arkCompile.maxSize、hvigor.enableMemoryCache。
2.  执行任务时关闭parallel模式。

#### 00306045 当compatibleSdkVersion为5.0.0(12)及以上时useNormalizedOHMUrl才可配置为true

**错误信息**

UseNormalizedOHMUrl can be true only when Compatible SDK Version is 5.0.0 (12) or later.

**错误描述**

当compatibleSdkVersion为5.0.0(12)及以上时，useNormalizedOHMUrl才可配置为true。

**可能原因**

工程级build-profile.json5中compatibleSdkVersion配置为4.1.0(11)或以下，并且useNormalizedOHMUrl设置为true。

**处理步骤**

如果compatibleSdkVersion为4.1.0(11)或以下版本，将useNormalizedOHMUrl设置为false。

#### 00306046 useNormalizedOHMUrl为false时不支持字节码HAR

**错误信息**

Bytecode HARs: XXX not supported when useNormalizedOHMUrl is not true.

**错误描述**

useNormalizedOHMUrl为false时不支持字节码HAR。

**可能原因**

工程级build-profile.json5中的useNormalizedOHMUrl配置为false，并且当前编译模块的依赖链上存在字节码HAR。

**处理步骤**

当前编译模块的依赖链上存在字节码HAR，将工程级build-profile.json5中的useNormalizedOHMUrl配置为true。

#### 00306047 多个HSP模块依赖同一个HAR

**错误信息**

Found HSPs that have the same HAR.

**错误描述**

多个HSP模块依赖同一个HAR。

**可能原因**

多个HSP模块依赖同一个HAR。

**处理步骤**

参考最佳实践：模块化设计。

#### 00306048 当前API版本不支持配置autoLazyImport

**错误信息**

autoLazyImport cannot be configured for the current API version. autoLazyImport can be used in the beta3 version of API 12 or higher versions.

**错误描述**

当前API版本不支持配置autoLazyImport，API 12 beta3及以上版本支持使用autoLazyImport。

**可能原因**

在API 12 beta3以下的版本中将autoLazyImport配置为true。

**处理步骤**

选择以下一种方式解决：

*   检查工程级build-profile.json5中的compatibleSdkVersion和compatibleSdkVersionStage字段，如果compatibleSdkVersion设置为API 12，则将compatibleSdkVersionStage设置为beta3。
*   将autoLazyImport配置为false。

#### 00306049 模块中存在重复的文件

**错误信息**

Duplicated files found in module XXX. This may cause unexpected errors at runtime.

**错误描述**

在模块XXX中存在重复的文件，可能会导致运行时错误。

**可能原因**

模块中存在相同名称的.so文件。

**处理步骤**

选择以下一种方式解决：

*   确保每个.so文件名都是唯一的。

*   通过pickFirsts、pickLasts或select字段设置.so文件的优先级。

#### 00306050 FA模型的项目不允许依赖外部项目模块

**错误信息**

This project is in the FA model and does not allow for external dependencies.

**错误描述**

FA模型的项目不允许依赖外部项目模块。

**可能原因**

FA模型的项目在build-profile.json5中，srcPath字段依赖了外部项目模块。

**处理步骤**

工程级build-profile.json5中，移除srcPath字段依赖的外部项目模块。

#### 00306051 Stage模型的项目不允许依赖FA模型的模块

**错误信息**

This project is in the stage model and does not allow for dependencies of modules in the FA model.

**错误描述**

Stage模型的项目不允许依赖FA模型的模块。

**可能原因**

在Stage模型的工程级build-profile.json5中srcPath字段引入了FA模型的工程模块。

**处理步骤**

工程级build-profile.json5移除对FA模型的工程模块的引用。

#### 00306052 不能依赖工程外的HAP模块

**错误信息**

Cannot depend on HAP modules outside of this project.

**错误描述**

不能依赖工程外的HAP模块。

**可能原因**

工程级build-profile.json5中srcPath字段依赖了项目外的HAP模块。

**处理步骤**

使用HSP或HAR模块替换项目外的HAP依赖。

#### 00306053 ohpm安装依赖失败

**错误信息**

ohpm install failed.

**错误描述**

ohpm安装依赖失败。

**可能原因**

网络不通，或ohpm镜像仓库地址、oh-package.json5中依赖的包名、版本号不正确。

**处理步骤**

请检查网络，或ohpm镜像仓库地址、oh-package.json5中依赖的包名、版本号是否正确。

#### 00306054 构建任务的命令无效

**错误信息**

Task XXX was not found in the project XXX. Invalid command to execute the build task, please verify the parameters in the command and try again.

**错误描述**

在工程中找不到任务，执行构建任务的命令无效，请检查命令行中的参数并重试。

**可能原因**

构建命令中的参数设置错误。

**处理步骤**

1.  执行“hvigorw --help”命令，了解有关hvigor命令的更多信息。
2.  执行“hvigorw tasks”命令，查看可用任务列表。
3.  执行命令时增加“--info”或“--debug”选项，获取更多日志输出。

#### 00306055 工程外的模块缺少配置

**错误信息**

Missing module configuration for external module outside the current project.

**错误描述**

工程外的模块缺少配置。

**可能原因**

使用了工程外的模块，但是没有在工程的build-profile.json5中配置模块信息。

**处理步骤**

检查工程级build-profile.json5，确保使用的所有模块都在modules字段中配置。

#### 00306056 hvigor守护进程异常退出

**错误信息**

A log of daemon process can be found at file: XXX.

**错误描述**

hvigor守护进程异常退出，可在XXX文件中查看日志。

**可能原因**

守护进程内存不足，具体原因可查看守护进程日志。

**处理步骤**

1.  修改hvigor-config.json5中nodeOptions下的maxOldSpaceSize，增加守护进程的内存。
2.  关闭守护进程后重新编译，验证该问题是否与守护进程有关。

#### 00306057 executableBinaryPaths-path的值应该是相对路径

**错误信息**

The executableBinaryPaths-path XXX should be a relative path. At file: YYY.

**错误描述**

executableBinaryPaths-path的值应该是相对路径。

**可能原因**

配置的executableBinaryPaths-path的值不是相对路径。

**处理步骤**

确保executableBinaryPaths-path的值是相对路径。

#### 00306058 应用skill的skillProfiles仅在bundleType为app或atomicService时可配置

**错误信息**

skillProfiles can be configured only when bundleType is set to app or atomicService. However, the current value of bundleType is XXX. At file: YYY.

**错误描述**

应用skill的skillProfiles仅在bundleType为app或atomicService时可配置。

**可能原因**

模块的module.json5中配置了skillProfiles，但是app.json5的bundleType不是app或atomicService。

**处理步骤**

*   删除module.json5中的skillProfiles。
*   将app.json5文件中的bundleType修改为app或atomicService。

#### 00306059 integratedHsp模块不支持skillProfiles配置

**错误信息**

The integratedHsp module does not support skillProfiles. At file: XXX.

**错误描述**

integratedHsp模块不支持skillProfiles配置。

**可能原因**

integratedHsp模块不支持skillProfiles配置。

**处理步骤**

*   删除module.json5中的skillProfiles。
*   在模块的build-profile.json5中将buildOption.arkOptions.integratedHsp设置为false。