Flutter应用提交华为应用市场审核时Huawei Site Kit无法访问如何解决

常见触发原因 #

• 审核设备的HMS Core版本过低：自测用设备的HMS Core版本符合Site Kit最低运行要求（通常为5.0.0.300及以上），但审核测试设备未升级到对应版本，低版本HMS Core会直接导致Site Kit接口调用失败
• 权限未正常授权：部分华为设备首次调用Site Kit接口时会触发HMS Core的位置、网络权限申请弹窗，若审核人员未通过权限申请，或系统拦截了HMS Core的弹窗，会导致接口请求无响应
• 地域服务限制：Site Kit搜索服务仅对已开通服务的国家/区域开放，若审核测试节点位于未开通服务的区域，且应用未做对应区域适配，就会出现搜索失败的问题
• 签名校验不通过：若开启了华为应用市场的签名代管服务，应用上架后实际分发的包签名会被替换为华为后台生成的签名，自测时使用的本地签名和上架后签名不一致，会导致Site Kit鉴权失败
• 打包配置异常：若release构建流程中未打包正确的agconnect-services.json文件，会导致Site Kit初始化失败，出现debug包自测正常、release包审核异常的情况
• 触发接口限流阈值：若审核阶段批量测试触发了Site Kit的默认接口调用限流阈值，会临时返回请求失败错误

对应解决方案 #

• 做版本兼容处理：应用启动时主动调用HuaweiApiAvailability.getInstance().isHuaweiMobileServicesAvailable(context)检测HMS Core版本，低于Site Kit最低要求版本时弹出引导提示，指引用户升级HMS Core后再使用相关功能
• 增加权限预申请和错误兜底：调用Site Kit搜索接口前，提前向用户申请位置、网络权限，同时增加接口错误码捕获逻辑，出现鉴权失败、权限不足、服务不可用等错误时弹出友好提示，避免功能直接无响应
• 修正签名配置：若开启了华为应用市场签名代管服务，需将华为后台生成的签名SHA256值，重新配置到AppGallery Connect的Site Kit服务配置项中，确保上架后包签名可以正常通过鉴权
• 检查打包配置：确认release构建配置中已引入正确的agconnect-services.json文件，打包完成后可解压APK验证配置文件是否存在、内容是否和AppGallery Connect后台一致
• 增加区域适配逻辑：调用Site Kit接口时优先传入用户当前所在区域参数，针对未开通Site Kit服务的区域做降级处理，可提示用户当前区域暂不支持搜索服务
• 提交审核时附加说明：在应用提交审核的备注栏，明确标注Site Kit功能的使用条件，包括所需权限、HMS Core版本要求、支持的区域范围，可同时附上Cloud Debugging中的测试录屏作为佐证，引导审核人员按正确流程测试
• 提升接口调用配额：预估应用访问量较大的情况下，提前在AppGallery Connect后台申请提升Site Kit的接口调用阈值，避免审核阶段触发限流

内容的提问来源于stack exchange，提问作者Foody