HarmonyOS鸿蒙Next中打包后har包在加载项目中时报10311002 ArkTS: ERROR

问题分析

1. byteCodeHar 配置被注释：您配置中 byteCodeHar 被注释掉了，这个配置对HAR包的构建类型至关重要
2. 混淆配置可能冲突：虽然混淆被禁用了（enable: false），但配置文件的存在可能导致构建工具处理逻辑异常
3. HAR包类型不匹配：加载项目期望的HAR包类型与实际构建的类型不一致

解决方案

方案1：启用字节码HAR（推荐）

修改您的 build-profile.json5 配置，取消注释并明确设置 byteCodeHar：

"buildOptionSet": [
  {
    "name": "release",
    "arkOptions": {
      "byteCodeHar": true,  // 关键配置：启用字节码HAR
      "obfuscation": {
        "ruleOptions": {
          "enable": false,
          "files": [
            "./obfuscation-rules.txt"
          ]
        },
        "consumerFiles": [
          "./consumer-rules.txt"
        ]
      }
    }
  }
]

方案2：如果必须使用源码HAR

如果确实需要源码HAR，需要完整配置并确保路径正确：

"buildOptionSet": [
  {
    "name": "release",
    "arkOptions": {
      "byteCodeHar": false,  // 明确设置为false
      "obfuscation": {
        "ruleOptions": {
          "enable": false
        }
      }
    }
  }
]

方案3：工程级配置同步

检查项目根目录下的 build-profile.json5，确保有正确的全局配置：

{
  "app": {
    "signingConfigs": [...],
    "useNormalizedOHMUrl": true  // 确保这个配置存在
  },
  "modules": [
    {
      "name": "您的har模块名称",
      "buildOption": {
        "arkOptions": {
          "byteCodeHar": true
        }
      }
    }
  ]
}

完整排查步骤

1. 清理构建缓存：

   • 在DevEco Studio中：File → Invalidate Caches → Invalidate and Restart
   • 手动删除项目下的 build 和 hvigor 缓存目录

2. 重新构建HAR包：

   hvigorw --clean      # 清理
   hvigorw assembleHap  # 重新构建
   

3. 验证HAR包内容：

   • 检查生成的HAR包是否包含正确的文件结构
   • 字节码HAR应包含 *.abc 文件，而不是 *.ets 源文件

4. 检查依赖版本：

   • 确保主项目和HAR包使用相同的API版本和SDK版本
   • 在 oh-package.json5 中检查依赖版本兼容性

预防措施

1. 统一配置管理：确保所有模块的 build-profile.json5 配置一致
2. 版本控制：HAR包发布到ohpm时，明确标注是字节码版本还是源码版本
3. 测试验证：在发布前，先在测试项目中验证HAR包的引用是否正常