Android Wear调用Google Fit API遇ApiException 17错误求助

你遇到的ApiException 17: Fitness.CLIENT is not available on this device错误，看似权限配置都没问题，但其实在Android Wear设备上有几个容易忽略的关键点，我帮你逐一拆解：

可能的原因及解决方法 #

1. Google Play服务版本不兼容 #

你项目中使用的play-services-fitness:11.8.0是非常旧的版本（2017年发布），而Android Wear设备上的Google Play服务如果低于这个版本，或者新版本GMS不再兼容旧版API，就会触发这个错误。

解决步骤：

• 打开手表的「设置」→「应用」→「Google Play服务」，查看版本号，确保它不低于你依赖的版本，最好升级到最新版；
• 升级项目中的依赖到最新稳定版，比如：

dependencies {
    // ...
    implementation 'com.google.android.gms:play-services-fitness:21.0.1'
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
    // ...
}

注意：升级后部分旧API可能已废弃，建议参考最新文档调整调用逻辑。

2. 手表设备不支持/未安装Google Fit服务 #

不是所有Android Wear设备都默认支持Google Fit：

• 部分第三方定制的Wear OS设备可能没有预装Google Fit服务；
• 旧款Wear设备（比如Wear OS 1.0）已停止对Google Fit API的支持。

解决步骤：

• 在手表的Play商店中搜索并安装「Google Fit」应用，确保用和手机绑定的同一Google账号登录；
• 确认你的手表运行的是Wear OS 2.0及以上版本（低于此版本的设备已不再被Google支持）。

3. 认证上下文或账号有效性问题 #

你在Service中调用Fitness.getHistoryClient时，依赖GoogleSignIn.getLastSignedInAccount(TrackerService.this)获取账号，但在Service中可能存在以下问题：

• 账号仅在手机端授权，未同步到手表；
• 服务启动时账号还未完成初始化，导致返回null。

解决步骤：

• 在调用Fit API前添加账号空值检查：

GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(TrackerService.this);
if (account == null) {
    // 重新引导用户在手表端完成Google Fit授权
    Log.d(TAG, "No signed-in account found on watch");
    return;
}
// 再执行insertData操作

• 确保手表上的Google账号已经通过你的应用授权了Google Fit权限（可以在手表的「设置」→「应用」→「你的应用」→「权限」中确认）。

4. Manifest配置缺失必要权限或声明 #

虽然你提到权限回调成功，但Android Wear设备可能需要额外的权限声明：

<!-- 添加必要的权限 -->
<uses-permission android:name="android.permission.BODY_SENSORS" />
<uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- 可选：添加Fit服务绑定声明（针对传感器相关操作） -->
<service
    android:name="com.google.android.gms.fitness.service.FitnessSensorService"
    android:permission="com.google.android.gms.permission.BIND_FITNESS_SERVICE" />

额外排查建议 #

• 先在Activity中测试Google Fit API的调用（比如在accessGoogleFit方法中添加简单的插入数据逻辑），确认在Activity上下文下能成功执行，再迁移到Service中；
• 检查手表的网络连接是否正常，Google Fit API需要联网验证设备兼容性和账号权限。

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