Unity 项目迁移鸿蒙（四）：联合登录报错 1002000001 排查
内容提要
鸿蒙联合登录报错1002000001，通常因团结引擎未配置或误用App ID、Client ID。需在Player设置中填写应用级参数，重新导出工程，并确认module.json5包含client_id和app_id。参数应从AGC应用区域获取，勿用项目级ID。验证时重导出、检查配置、清理重建并重装测试。
延伸解读
错误码 1002000001 的常见诱因
该错误码通常并非登录逻辑本身出错，而是应用身份参数缺失或错误。团结引擎项目若未配置 App ID 和 Client ID，或误用了 AGC 项目级参数，就会导致认证信息不匹配。因此，遇到此错误应优先检查应用级标识配置，而非调试登录代码。
正确区分 AGC 中的应用级与项目级参数
AGC 中同时存在项目级和应用级标识，名称相似易混淆。联合登录所需的是当前应用对应的参数：App ID 应使用应用区域中的值，而非项目 ID；Client ID 也应使用应用区域中的值，而非项目区域中的 Client ID。获取路径为：开发与服务 > 项目设置 > 常规，在应用区域查找。
配置生效与验证的关键步骤
在团结引擎的 Player > Publishing Settings 中填写 App ID 和 Client ID 后，必须重新导出 OpenHarmony 工程。若继续使用旧工程，需手动更新 entry/src/main/module.json5，确保 module.metadata 中包含 client_id 和 app_id 两项。长期方案建议直接修改 OpenHarmony 工程配置，避免被导出覆盖。
错误仍存在时的排查方向
若按上述步骤配置后错误依旧，应检查联合登录服务是否已为该应用启用、证书与签名是否匹配，以及测试账号是否满足服务要求。同时确认 AGC 应用包名、工程包名和签名配置相互匹配，并在 DevEco Studio 中清理重建、卸载旧包后重装测试。
Q&A
鸿蒙联合登录报错1002000001是什么原因？
通常是因为OpenHarmony工程中缺少正确的App ID或Client ID，或者误用了AGC的项目级参数，导致认证信息不匹配。
在团结引擎中如何配置鸿蒙联合登录所需的App ID和Client ID？
打开Project Settings > Player > Publishing Settings，在OpenHarmony Module Configuration中填写App ID和Client ID，保存后重新导出OpenHarmony工程。
如何从AGC获取正确的App ID和Client ID？
登录AGC，进入目标应用，打开“开发与服务 > 项目设置 > 常规”，在“应用”区域获取App ID和Client ID，不要使用项目ID或项目区域中的Client ID。
导出OpenHarmony工程后，需要检查module.json5中的哪些字段？
检查entry/src/main/module.json5中module.metadata是否包含client_id和app_id两项，值应为正确的应用级参数。
修改配置后如何验证联合登录是否正常？
按顺序：重新导出工程、检查module.json5字段、确认包名和签名匹配、在DevEco Studio中清理并重新构建、卸载旧包后安装新包测试。
如果配置正确但错误1002000001仍然存在，应该检查什么？
应检查联合登录服务是否已为该应用启用、证书与签名是否匹配，以及测试账号是否满足服务要求。
