HarmonyOS鸿蒙Next中寻求大佬帮助,项目初始化失败,ERROR: 00308002 Operation Error
HarmonyOS鸿蒙Next中寻求大佬帮助,项目初始化失败,ERROR: 00308002 Operation Error “D:\Tools\DevEco Studio\tools\node\node.exe” “D:\Tools\DevEco Studio\tools\hvigor\bin\hvigorw.js” --sync -p product=default --analyze=normal --parallel --incremental --no-daemon
Installing dependencies…
WARN GET https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/@hadss%2Fhmrouter-plugin error (UNABLE_TO_VERIFY_LEAF_SIGNATURE). Will retry in 10 seconds. 2 retries left.
WARN GET https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/@hadss%2Fhmrouter-plugin error (UNABLE_TO_VERIFY_LEAF_SIGNATURE). Will retry in 1 minute. 1 retries left.
ERR_PNPM_META_FETCH_FAIL GET https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/@hadss%2Fhmrouter-plugin: request to https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/@hadss%2Fhmrouter-plugin failed, reason: unable to verify the first certificate
This error happened while installing a direct dependency of C:\Users\hpt.hvigor\project_caches\3c6bcd556341237e49c5f2d63e37696c\workspace
> hvigor ERROR: 00308002 Operation Error
Error Message: C:\Users\hpt.hvigor\wrapper\tools\node_modules.bin\pnpm.cmd install execute failed.
* Try the following:
> See above for details.
Process finished with exit code -1
更多关于HarmonyOS鸿蒙Next中寻求大佬帮助,项目初始化失败,ERROR: 00308002 Operation Error的实战教程也可以访问 https://www.itying.com/category-93-b0.html
通常是由于HTTPS证书验证失败引起,可以暂时取消ssl验证,将npm包管理器的strict-ssl的值改为false,具体操作如下:
npm config set strict-ssl false
通过如下命令确认是否修改成功:
npm config get strict-ssl
如果上述方法仍未解决,可尝试卸载和重装DevEco Studio和node环境。
更多关于HarmonyOS鸿蒙Next中寻求大佬帮助,项目初始化失败,ERROR: 00308002 Operation Error的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
参考文章:build init失败hvigor ERROR: 00308002 Operation Error-华为开发者问答 | 华为开发者联盟
注意:使用 DevEco Studio 时安装依赖的话(使用ohpm)不支持 npm
鸿蒙Next项目初始化失败,错误码00308002通常与IDE配置或环境问题有关。请检查DevEco Studio是否为最新版本,确认Node.js和ohpm包管理器已正确安装且版本匹配。同时,验证项目路径是否包含中文字符或特殊符号,并确保网络连接正常,能访问HarmonyOS SDK仓库。
根据你提供的错误日志,问题核心在于 SSL/TLS 证书验证失败,导致无法从华为的中央仓库下载依赖包 @hadss/hmrouter-plugin,进而引发 00308002 操作错误。
具体错误信息是:
reason: unable to verify the first certificate 和 UNABLE_TO_VERIFY_LEAF_SIGNATURE。
这是一个典型的网络代理或系统安全软件(如防火墙、杀毒软件)干扰了HTTPS连接,导致Node.js/npm/pnpm无法验证华为仓库服务器证书链的问题。
解决方案如下:
- 检查网络代理设置:如果你在公司网络或使用了代理,请确保DevEco Studio和Node.js的代理配置正确。可以尝试在纯净的网络环境(如关闭代理、切换热点)下重试。
- 暂时关闭SSL验证(临时解决方案,不推荐用于生产环境):
- 在项目根目录或用户目录下,为
npm或pnpm设置严格SSL为false。 - 对于pnpm(从日志看使用的是pnpm),可以尝试在命令行执行(或检查环境变量):
pnpm config set strict-ssl false - 或者设置
NODE_TLS_REJECT_UNAUTHORIZED=0环境变量。注意:这会降低连接安全性,仅用于临时排查。
- 在项目根目录或用户目录下,为
- 检查系统时间和时区:不正确的系统时间会导致证书验证失败,请确保你的电脑系统时间准确。
- 检查安全软件:临时禁用防火墙、杀毒软件或网络安全软件,看是否是其拦截或篡改了HTTPS连接。
- 清理缓存并重试:
- 清理Hvigor缓存:删除项目目录下的
.hvigor和node_modules文件夹(如果存在)。 - 清理pnpm全局缓存:
pnpm store prune。 - 在DevEco Studio中执行 File > Invalidate Caches and Restart…。
- 重启后,在项目根目录打开终端,尝试先运行
pnpm install或npm install手动安装依赖。
- 清理Hvigor缓存:删除项目目录下的
- 更新工具链:确保你使用的DevEco Studio、Node.js、以及项目中的
@ohos/hvigor、@ohos/hvigor-ohos-plugin等构建插件版本是最新的,与HarmonyOS Next SDK匹配。
最可能直接解决问题的方法是 在无代理干扰的网络环境下重试,或 临时配置 strict-ssl=false 后重试项目同步。

