为何Google Fit API返回200成功但步数数据未同步显示？

1. 时间戳校验 #

• 检查fillStepsData生成的每个DataPoint的时间戳是否符合要求：
  • 所有时间戳必须是毫秒级的Unix时间戳，且起始时间早于结束时间，不能出现时间范围重叠的DataPoint
  • 时间范围不能超过当前时间，也不能早于1970年，异常时间戳会被后台静默过滤
  • 小时级统计的步数值不能超过合理阈值（单小时步数建议不超过2万），异常高值会被Google Fit判定为无效数据直接丢弃，不会返回错误

2. 数据源配置校验 #

• 你当前的数据源配置未指定设备信息，当同一账号绑定多台可穿戴设备时，Google Fit可能会优先展示设备原生上报的步数，将你的应用上报的数据标记为非优先数据源隐藏，建议补充设备信息配置：

  val dataSource = DataSource.Builder()
      .setAppPackageName(context)
      .setDataType(DataType.TYPE_STEP_COUNT_DELTA)
      .setStreamName(TAG + AppConstants.STEPSCOUNT_FIT.value)
      .setType(DataSource.TYPE_RAW)
      // 补充当前设备信息
      .setDevice(Device.fromContext(context))
      .build()
  

3. 数据插入逻辑校验 #

• 不要复用同一个DataSet实例重复插入，多次插入相同时间范围的同类型数据会触发Google Fit的去重逻辑，重复数据会被直接丢弃
• 若你的readHistoryData查询逻辑可以读到插入的数据但Google Fit应用看不到，说明是数据聚合展示优先级问题：你上报的TYPE_STEP_COUNT_DELTA数据会和其他数据源的数据聚合，如果对应时间段内有优先级更高的数据源（比如手机本身的计步传感器、绑定的智能手表）上报了数据，Google Fit默认会展示优先级更高的数据源的统计结果，你的数据会被归入「其他来源」不会在首页直接展示

4. 权限校验 #

• 确认你申请了ACTIVITY_RECOGNITION运行时权限以及Google Fit对应的fitness.activity.writeOAuth权限，权限被回收的情况下部分插入请求会被后台静默返回成功但实际不存储数据，建议每次插入前先校验权限是否有效

5. 同步延迟校验 #

• Google Fit应用不会实时同步后台插入的所有数据，正常延迟范围是10-15分钟，插入后立刻查看很可能看不到数据，可以手动下拉刷新Google Fit首页触发强制同步，或者等待15分钟后再查看

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