HarmonyOS鸿蒙Next调试相关问题

问题解决：

问题一：发布证书打包测试仍报错1001500001是否正常？

原因分析：

返回错误码 1001500001（应用指纹证书校验失败）属于异常情况，常见原因包括：

• client_id配置错误：module.json5 中配置的 client_id 与AGC（AppGallery Connect）平台不一致。
• 指纹证书未生效：在AGC平台更新证书后未等待生效（通常需要10分钟）或未更新本地 versionCode 触发缓存刷新。
• 证书不匹配：发布证书的指纹未正确添加到AGC平台，或打包时使用了错误的签名文件。

解决步骤：

1、检查client_id配置：

确保 entry 模块下的 module.json5 文件中 client_id 值与AGC平台完全一致，格式应为 “value”: “实际值”，而非引用字符串资源（如 “$string:clientId”）。

2、验证指纹证书配置：

• 登录AGC平台，进入项目设置，检查应用的 公钥指纹 是否已添加且与本地发布证书的SHA256指纹一致。
• 若更换过证书，需在AGC平台删除旧指纹并重新添加新指纹。

3、触发证书生效：

修改 app.json5 中的 versionCode 值（如递增版本号），重新打包并测试。

问题二：调试证书配置后调用登录接口仍报错401

错误分析：

错误码 401 通常表示参数错误或用户授权未通过，具体原因可能包括：

1、接口参数格式错误：

• createAuthorizationWithHuaweiIDRequest 或 createLoginWithHuaweiIDRequest 的输入参数（如样式参数 style）不符合规范。
• 若使用华为账号登录按钮样式，需确认 style 设置为 BUTTON 类型（如 BUTTON_RED 或 BUTTON_WHITE），而非 ICON 类型。

2、权限或Scope缺失：

• 未在 module.json5 中声明 ohos.permission.ACCOUNT_MANAGER 或其他华为账号相关权限。
• 未在 scopes 参数中申请必要的权限（如手机号授权需添加 “phone”）。

3、调试证书与接口权限不兼容：

确保调试证书绑定的应用Bundle ID与AGC平台注册的一致，且已开启华为账号相关服务。

解决步骤：

1、检查参数配置：

对比接口参数与华为官方文档示例，重点检查以下字段：

// 示例：华为账号登录按钮样式
const params = {
  style: abilityAccessCtrl.HuaweiIdAuthButtonStyle.BUTTON_RED, // 必须为BUTTON类型
  // 其他参数...
};

2、补充权限声明：

在 module.json5 中添加账号权限：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.ACCOUNT_MANAGER"
      }
    ]
  }
}

3、检查Scope配置：

若需获取用户敏感信息（如手机号），在调用接口时需传入 scopes 参数并申请对应权限：

const scopes = ["phone"]; // 根据业务需求调整

const authRequest = await abilityAccessCtrl.createAuthorizationWithHuaweiIDRequest(scopes);

通用注意事项

1、签名一致性：

Debug与Release包的签名证书需保持一致，避免因签名差异导致指纹校验失败。

2、真机测试：

部分权限（如后台定位）需在真机测试，模拟器可能无法复现问题。

3、日志排查：

通过IDE日志过滤关键字（如 quickLoginWithHuaweiID）确认接口调用流程是否完整。