Flutter Health包requestAuthorization()始终返回false问题咨询

1. 核对GCP OAuth配置 #

• 确认OAuth 2.0客户端ID与应用端配置匹配：安卓端需填写正确的包名、调试+发布版本的SHA-1签名，iOS端需填写正确的Bundle ID，任意一项不匹配都会触发授权失败。
• 确认OAuth同意屏幕的状态：如果处于测试模式，你当前设备登录的Google账号必须在测试用户列表内，测试模式下仅列表内的账号可正常授权，且单项目测试用户上限为100个。
• 核对权限申请范围：步数数据获取不需要Gmail相关权限，检查你调用requestAuthorization()时传入的types参数是否仅包含HealthDataType.STEPS，多余的Gmail相关scope会触发额外的权限校验流程。

2. 校验端侧权限配置 #

• 安卓端需在AndroidManifest.xml中添加活动识别权限，安卓13及以上版本必须申请该权限才能获取步数数据：

<!-- 安卓活动识别权限 用于获取步数 -->
<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" />

• iOS端需在Info.plist中添加健康数据读写的权限说明，无说明的授权请求会被系统直接拦截：

<key>NSHealthShareUsageDescription</key>
<string>需要访问健康数据以统计步数信息</string>
<key>NSHealthUpdateUsageDescription</key>
<string>需要读取健康数据以统计步数信息</string>

• 调用授权方法前先调用hasPermissions()方法预校验授权状态，避免重复调用requestAuthorization()触发Google服务的临时限流。

3. 异常场景排查 #

• GCP测试用户列表更新有10-15分钟的延迟，新增测试用户后等待一段时间再测试，可先将现有账号从列表删除重新添加，刷新配置缓存。
• 清除设备上的Google Play服务缓存、卸载应用后重新安装测试，排除本地缓存的旧授权状态导致的异常。
• 排查项目中其他已集成的Google服务（如Google登录）的scope配置，确认是否误加了Gmail相关权限，可单独创建最小示例项目测试flutter_health的授权逻辑，排除其他服务的干扰。

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