Flutter中调用People API无法获取Google联系人邮箱，其余字段显示正常

你遇到的是Google People API调用中非常典型的权限粒度不匹配问题，具体触发原因对应三个高频踩坑场景：

• Scope权限粒度不匹配：你配置的https://www.googleapis.com/auth/contacts 通用联系人scope，在当前Google的权限拆分规则下，默认仅开放联系人的姓名、电话号码、头像字段的读取权限；如果需要拉取联系人的emailAddresses 字段，光靠这个通用scope是不够的，必须明确申请对应的细分只读权限，且确保用户在授权流程中明确同意了邮箱读取的授权项。
• 本地缓存的旧Token权限不足：Flutter生态的google_sign_in 插件会默认缓存用户的授权状态，如果你在开发过程中曾经给当前账号授权过仅包含姓名、电话读取权限的旧版scope，后续哪怕修改了代码里的scope配置，插件也不会自动触发重新授权流程，最终调用接口携带的access token本身就不具备读取邮箱字段的权限——这种场景最迷惑人的特征就是接口会正常返回200状态码，但会把所有你无权限读取的字段直接剔除，仅返回每个联系人的resourceName、etag 两个基础字段。
• 请求参数格式不匹配：如果拼接请求参数时，把emailAddresses 字段名错写为email、emails 这类不符合接口规范的名称，接口不会抛出参数解析错误，会直接静默忽略无效的字段申请，最终返回的结构中自然不会包含邮箱相关数据。

按优先级从高到低操作即可：

• 第一步清理本地旧授权缓存：在代码中调用googleSignIn.signOut() 强制退出当前登录态，完全清除本地存储的旧access token、历史授权scope记录，避免旧缓存干扰新的权限申请。
• 第二步调整授权scope配置：将原有单一的https://www.googleapis.com/auth/contacts 替换为细分的只读权限配置，确保授权流程中会弹出邮箱读取的授权选项：
  • 使用https://www.googleapis.com/auth/contacts.readonly 作为授权scope
• 第三步校验请求参数逻辑：
  • 确认personFields 参数的字段名完全匹配接口规范，拉取邮箱就严格填写emailAddresses，不要使用简写命名
  • 对拼接的URL参数做标准编码，避免逗号、空格导致的参数解析异常
• 第四步单独验证权限有效性：清缓存重新授权拿到新token后，单独发送一次仅请求personFields=emailAddresses 的接口测试，如果此时能正常返回邮箱数据，说明之前的问题出在旧token权限不足；如果依然拿不到数据，就去检查Google OAuth后台的同意屏幕配置，确认已经开启联系人邮箱读取的权限项，没有将该权限设置为应用不可申请的受限权限。

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