134******05华为帐号服务
用户身份服务
Account Kit
Online Authentication Kit
User Authentication Kit
在使用AGC华为账号一键登录时遇到403问题
1.项目参数已经配置,并且可以和认证服务器通讯。
2.在使用华为账号登录时,后台报错ResponseCode:403,responseMsg:undefined。
有大佬遇到过同样的问题吗,有人有相关的解决经验吗。
1.Client ID和密钥都已配置。
2.services.json已放置到指定位置。
3.项目结构内证书设置为关联已注册应用。


空瞳
从描述看,客户端已经能拉起华为帐号流程,但“后台”返回 ResponseCode: 403,建议先把它按服务端换取/校验帐号凭据阶段的鉴权失败来排查,而不是只看 services.json 是否已放置。
Account Kit 登录结果中的 authorizationCode 是临时凭据,服务端需要用同一个 AGC 应用对应的 Client ID/密钥去换取 token 或用户信息;如果客户端应用、签名证书、scope/permission 或服务端 Client 配置不一致,就容易被 403 拒绝。建议按这个顺序查:
1. 确认真机/模拟器里安装包的 bundleName/package 与 AGC 注册应用一致,当前调试或发布证书的 SHA-256 指纹已配置到同一个应用下。换过签名证书后,要重新下载配置文件并重新打包。
2. 后端使用的 Client ID、Client Secret 必须与当前 HarmonyOS 应用属于同一个 AGC 项目/应用,避免混用 Web 客户端、其他包名应用或旧项目的 Client 信息。
3. 如果请求了手机号、匿名手机号、riskLevel 等 scope/permission,先确认对应权限已申请并通过。Account Kit 中未申请所需 scope/permission 会对应 1001502014,不支持的 scope/permission 会对应 1001500003;建议客户端也打印 executeRequest 的 BusinessError.code 和 message。
4. 后端换取用户信息时要传客户端刚获取到的 authorizationCode,并注意该 code 只能用一次、有效期较短;重复使用、过期,或和错误 Client ID 搭配,都可能导致服务端拒绝。
5. 不要只打印 responseMsg,建议把后端调用接口的完整响应体、错误码以及 requestId/traceId 一并记录,方便区分是签名指纹校验、scope 权限,还是服务端凭据不匹配。
如果客户端 executeRequest 本身失败,优先看 1001500001、1001502002、1001502014 等错误码;如果客户端已成功拿到 authorizationCode,只是后台 403,重点检查第 2、4、5 项。
134******05好的我排查下。2026-07-01 14:00 来自湖南
Ali Development那个回复


134******05这个肯定是添加了的,对着文档一步步配置的,估计是项目名称与软件名称与AGC上的项目名不匹配的问题2026-07-03 03:33 来自湖南

结语:不知道原始的项目中配置文件改了什么,也有可能是应用的名称不匹配,导致认证被拒绝,重新建立空白应用进行配置后,便可以直接获取到登录信息了,目前的解决方案是将原有项目的UI和组件移植到空白项目中。
Ali Development日志返回:responseCode:403, responseMsg:undefined,403代表服务端鉴权拒绝请求,在鸿蒙Next AGC账号登录场景里,不是单纯网络问题,是客户端发给AGC鉴权网关的凭证/签名/应用绑定关系校验不通过。你当前代码调用的是auth.signIn({kind:'hwid'}) HWID华为账号一键登录,下面按鸿蒙6.0 Next开发规范分维度严谨排查,按优先级从上到下核对。一、工程基础配置校验(90% 403根源)1. agconnect-services.json 配置与放置规范(鸿蒙Next强制要求)文件来源:必须从AGC控制台对应HarmonyOS应用下载,不能复用安卓的agconnect-services.json,两者字段不互通,混用直接403;放置路径:鸿蒙Next工程需放在 entry/src/main/resources/rawfile/agconnect-services.json,不能放错目录;核心字段核对(打开文件检查):client/app_id、client/client_id、client/client_secret 与AGC后台应用信息完全一致;service/hwid/hwid_client_id 存在且不为空,HWID登录依赖该字段,缺失直接鉴权403;同步签名信息:json内client/cert_fingerprint 指纹必须和当前调试/打包证书SHA256完全匹配,签名指纹不一致是最常见403诱因。2. 项目build.gradle/oh-package.json5 SDK依赖与模块配置(1)模块依赖(entry/oh-package.json5)鸿蒙6.0 Next 纯ArkTS工程依赖AGC账号SDK,版本要适配鸿蒙6,不要用老旧版本:V坑(2)工程级签名配置(工程根目录 build-profile.json5)进入AGC控制台→你的项目→HarmonyOS应用,确认应用包名(bundleName) 和工程entry/oh-package.json5里name完全一致,大小写不能错;华为账号服务(Account Kit)开关必须开启:控制台→增长→用户身份认证→华为账号,开启服务,未开启网关直接拦截返回403;客户端ID白名单:检查客户端ID没有被




Ali Development
调试必须配置有效p12签名,鸿蒙Next不允许无签名真机调试AGC服务;
签名文件的SHA256指纹,必须在AGC控制台→项目设置→应用→HarmonyOS应用内录入,同时同步到agconnect-services.json的cert_fingerprint字段。
3
页面内调用不能重复初始化,直接获取全局实例
你现有代码缺少前置初始化,页面内直接auth.signIn,SDK无法组装合法签名报文,网关校验403。2026-07-01 14:32 来自广东
134******05回复Ali Development好的我,改下看看,你这里提到的有些点我确实没配置到2026-07-01 14:50 来自湖南
134******05回复134******051.agconnect-services需要放到appScope/resources/rawfile目录内,放置到Entry资源目录会直接报AuthToken错误。且该文件内没有service/hwid/hwid_client_id字段,需要手动添加吗。也没有client/cert_fingerprint字段,同上。
2026-07-01 15:14 来自湖南
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS AGC应用下载直达功能无法跳转应用市场 (API12+)
HarmonyOS App Linking开发时,AGC上的域名应该填什么?(API12+)
HarmonyOS AGC平台应用分析指标说明咨询 (API12+)
HarmonyOS 代码中获取的AppID和AGC后台的AppID有什么区别(API12+)
HarmonyOS 华为账号一键登录报错1001502003,如何解决?(API12+)
HarmonyOS 华为账号登录失败(API12+)
HarmonyOS 申请华为账号一键登录未通过,运行提示1001502014错误(API12+)
HarmonyOS 华为账号一键登录问题 (API12+)




































苏公安网备 32011402010933号