鸿蒙应用元服务开发-Account Kit 常见问题说明

一、OpenID和UnionID的格式说明

（一）长度

为减少开发者接入和迁移成本，Account Kit在2023年09月21日对OpenID、UnionID的长度做出了如下调整：

OpenID

应用创建时间晚于（含）2023年09月21日 23:00:00，OpenID固定28位。

应用创建时间早于2023年09月21日 23:00:00，OpenID长度不固定，最大256位。

UnionID

开发者账号注册时间晚于（含）2023年09月21日 23:00:00，UnionID固定29位。

开发者账号注册时间早于2023年09月21日 23:00:00，UnionID长度不固定，最大92位。

（二）唯一性标识

开发者账号下管理了多个应用时，针对同一个华为账号，不同的应用返回的OpenID值不同，但返回的UnionID相同。

如果开发者账号下管理了多个应用，并且这些应用需要共享同一个华为账号的用户信息，可以使用UnionID作为用户标识。

（三）数据类型

OpenID和UnionID均是字符串类型的数据。

（四）大小写敏感

OpenID和UnionID严格区分大小写。

（六）实际应用中的注意事项

在存储、查询或比较OpenID或UnionID时，请务必保持其原始的大小写格式。

二、Access Token和Refresh Token的有效时长是多久

Access Token的有效时长是1个小时，Refresh Token的有效时长是180天。

三、Access Token和Refresh Token长度限制要求

Access Token和Refresh Token的长度与其中编码的信息有关，目前来讲Access Token和Refresh Token的长度不会超过1024字符。

四、调用接口获取应用级Access Token时，是否有次数和频率限制

单个元服务在1小时内最多允许10000次调用获取应用级Access Token，超过该限制次数后失败。详细流控机制请参见华为OAuth应用级Access Token流控机制。

五、无法获取手机号或获取到的手机号为空如何解决

在手机号快速验证场景下，无法获取到明文手机号时，建议通过以下步骤排查解决：

请先检查手机号快速验证权限是否成功申请，详情可参考配置scope权限。

确认权限申请成功后，确认scope参数是否符合预期，手机号快速验证可参考快速验证客户端开发。

若调用接口还未获取到手机号，可将调试设备系统时间向后调整24小时。

六、未成年人模式开启后USB断连如何解决

开发者可以进入设置-系统-开发者选项，点击USB调试开关，会校验健康使用设备密码，校验成功后可解除开发者调试模式限制。

如开发者重新开启USB调试开关后，发现DevEco Studio工具上hilog日志未恢复到断连之前，请执行“hdc shell hilog -G 16M”来扩大hilog日志缓存区，若hilog日志仍无法完全展示，可取出hilog日志本地查看。更多命令请参见hilog。

本文主要引用参考HarmonyOS官方网站