华为 Pura 80 Pro 调用 HiLens OpenAPI 返回 401 故障排查
# 华为 Pura 80 Pro 调用 HiLens OpenAPI 返回 401 故障排查
## 背景与适用场景
华为 HiLens(华为机器视觉服务)是 HMS Core 生态中的核心 AI 能力组件,为开发者提供端侧模型部署、推理调用和设备管理能力。当前主流支持设备涵盖 Mate 60 系列、Pura 70 系列、Pura 80 Pro 等 HarmonyOS 5.0 及以上机型。然而,由于 HiLens 采用基于 HMS Core 的五层鉴权体系(设备级→应用级→签名级→权限级→时间同步级),任何一层配置偏差均会触发 401 鉴权失败,这也是华为开发者社区中反馈频次最高的故障类型之一。
本文档适用于以下典型场景:
– 设备侧应用(而非云侧服务器)直接调用 HiLens REST API
– Pura 80 Pro 设备在 HarmonyOS 5.0 环境下进行 AI 能力集成
– 开发者从华强北采购设备或更换调试证书后出现偶发性 401
—
## 现象
调用华为 HiLens Studio REST API 时,请求返回 HTTP 401,响应体如下:
“`json
{
“error_code”: “1002”,
“error_msg”: “鉴权失败,请检查AppId和ClientId是否正确”
}
“`
设备为 Pura 80 Pro,系统版本 HarmonyOS 5.0,调用端为设备侧应用(非云侧)。
补充说明:在华为 HMS API 错误体系中,错误码 1002 特指客户端认证层失败,与 1001(参数缺失)、1003(签名不匹配)属于同一错误族系,但根因定位路径截然不同。1002 的核心特征是「客户端身份未被 API 网关认可」,而非「请求内容本身有问题」,这意味着问题出在调用端配置而非接口调用逻辑。
—
## 可能原因
### 原因一:agconnect-services.json 未正确注入
HarmonyOS …