HarmonyOS 鸿蒙Next中真机调试报ErrorCode: 00401026

HarmonyOS 鸿蒙Next中真机调试报ErrorCode: 00401026

华为mate70，上周收到推送手机补丁，点了更新。

之前SDK12的时候能正常调试，然后真机调试就不行了。

更新deveco到目前最新版本，SDK更新成了最新,真机调试依然报错。

手机和开发环境API版本都是5.0.5（17）

还有就是，设备显示null不知道是不是正常。

ErrorCode: 00401026

ErrorDescription: The deviceType or apiVersion of the target device does not match that configured in the module.json5 file.


更多关于HarmonyOS 鸿蒙Next中真机调试报ErrorCode: 00401026的实战教程也可以访问 https://www.itying.com/category-93-b0.html

6 回复

开发者您好，根据目前提供的信息，建议尝试“hdc kill -r”，重启hdc服务。

编译器报错可能的原因：编译器未能通过hdc命令获取到设备类型或者API。

若未能解决问题麻烦您提供如下信息：

  • 问题电脑hdc日志：C:\Users{用户名}\AppData\Local\Temp\hdc.log*
  • 问题电脑编译器日志：Help-Show Log in Explorer
  • 问题电脑SDK版本：Help-About HarmonyOS SDK
  • 出现问题时的手机日志信息：可通过无问题编译器的Device File Browser导出/data/log/hilog

更多关于HarmonyOS 鸿蒙Next中真机调试报ErrorCode: 00401026的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


  1. 楼主可以检查一下build-profile.json5中compatibleSdkVersion声明的版本是多少

  2. 楼主要检查一下其他的包的设备类型是否一致，src/main/module.json5

{
  "module": {
    "name": "*****",
    "type": "shared",
    "description": "$string:shared_desc",
    "deviceTypes": [
      "phone",
      "tablet"
    ],
    "deliveryWithInstall": true,
//    "installationFree": true,
    "pages": "$profile:main_pages"
  }
}

常见的就是这两个问题导致的，还有就是代码里面使用的API高于编译器的版本或者存在不支持使用的API

你这个报错The deviceType or apiVersion of the target device does not match that configured in the module.json5 file是说设备类型或API版本与工程配置不匹配吧？和电脑关系不大啊。

打开module.json5看一下SDK版本：

"compileSdkVersion": 17, // 需与SDK版本完全一致
"compatibleSdkVersion": 17,
"targetSdkVersion": 17

然后再清理开发环境缓存，在DevEco Studio中选择 File > Invalidate Caches / Restart，点击Invalidate and Restart。最后手动删除用户目录/.gradle/caches文件夹。

换了台电脑安装相同版本的开发环境和SDK，还是这台手机，然后能真机调试了。

该错误码00401026表示鸿蒙Next真机调试时出现签名验证失败。可能原因包括：

  1. 调试证书未正确配置；
  2. 设备未授权调试；
  3. 应用签名与设备记录不匹配。

解决方法：检查开发者选项中的调试证书配置，确保设备已开启USB调试授权，清除设备上旧版本应用的签名缓存数据。

从错误信息来看，00401026 错误是由于设备类型或 API 版本不匹配导致的。具体建议如下：

  1. 检查 module.json5 文件中的 deviceType 配置是否包含 "phone" 类型，确保与 Mate70 设备类型匹配。

  2. 虽然显示 API 版本都是 5.0.5(17)，但建议：

    • 在 DevEco Studio 中重新下载对应 SDK。
    • 在项目级 build.gradle 中确认 compileSdkVersion 和 compatibleSdkVersion 设置正确。

  3. 设备显示 null 不正常，可能是 USB 调试授权问题：

    • 断开 USB 重新连接。
    • 在手机开发者选项中撤销 USB 调试授权后重新授权。
    • 检查是否启用了 “仅充电” 模式，改为 “文件传输” 模式。

  4. 可以尝试清除项目缓存 (Build > Clean Project) 并重启 DevEco Studio。

  5. 如果问题依旧，建议检查手机系统是否为开发者预览版，某些预览版可能存在兼容性问题。

回到顶部