接入鸿蒙联合登录后，如果接口返回错误码 1002000001，很可能不是登录代码本身的问题，而是 OpenHarmony 工程中缺少正确的 App ID 或 Client ID。本文记录这个容易被忽略的配置问题，并说明如何在 AGC 中找到对应应用的参数。

问题现象

调用鸿蒙联合登录接口时返回：

Code: 1002000001

如果登录接口已经能够正常发起，但随后立即返回该错误，可以优先检查应用身份参数。团结引擎项目中没有配置 App ID 和 Client ID，或者误用了 AGC 的项目级参数，都可能导致认证信息不匹配。

在团结引擎中配置应用参数

打开团结引擎的以下设置页面：

Project Settings > Player > Publishing Settings

在 OpenHarmony Module Configuration 中填写：

  • App ID
  • Client ID

保存设置后，需要重新导出 OpenHarmony 工程。如果继续使用旧的 DevEco Studio 工程，可以参照下面检查导出结果中的格式，手动把这两项 metadata 补进 entry/src/main/module.json5。

检查导出结果

重新导出后，打开：

entry/src/main/module.json5

确认 module.metadata 中包含以下两项：

{
  "name": "client_id",
  "value": "your_client_id"
},
{
  "name": "app_id",
  "value": "your_app_id"
}

如果字段没有生成，先检查团结引擎中的配置是否已经保存。使用旧工程时，可以手工把这两项 metadata 补进 entry/src/main/module.json5，改完重新构建即可，不必为了验证这两个字段重新导出。

正确获取 Client ID 和 App ID

AGC（AppGallery Connect）中同时存在项目级和应用级标识，名称相近，很容易混淆。联合登录所需的是当前应用对应的参数，而不是项目分区中的 项目 ID 或项目级 Client ID。

登录 AGC 后，进入目标应用，再依次打开：

开发与服务 > 项目设置 > 常规

在页面中找到当前应用对应的“应用”区域，并获取：

参数 应使用的值 常见误用
App ID 应用区域中的 App ID 项目 ID
Client ID 应用区域中的 Client ID 项目区域中的 Client ID

修改后的验证步骤

完成配置后，建议按照以下顺序验证：

  1. 检查 entry/src/main/module.json5 中的两个 metadata 字段；
  2. 确认 AGC 应用包名、工程包名和签名配置相互匹配；
  3. 在 DevEco Studio 中清理并重新构建应用；
  4. 卸载设备上的旧包，再安装新包测试联合登录。

如果错误仍然存在，应继续检查联合登录服务是否已经为该应用启用、证书与签名是否匹配，以及测试账号是否满足服务要求。