Google JWT令牌中locale声明突然缺失的原因咨询

以下是几个可能触发该问题的核心原因及排查方向：

• Google OIDC服务的隐性灰度调整：Google偶尔会对OIDC响应做小范围后台调整，这类变更可能不会同步到公开文档，尤其是灰度推送阶段。即使文档说明name存在时locale应返回，实际执行中可能因内部逻辑调整暂时不返回该字段。
• 授权请求参数的隐性变化：检查应用发起OIDC请求的scope参数，确保profile权限未被误移除。虽然name字段存在，但locale的返回可能依赖完整的profile scope；另外可尝试显式指定claims参数强制获取locale：

  {
    "id_token": {
      "locale": {"essential": true}
    }
  }
  

  若强制后仍无返回，可直接定位到Google侧的问题。
• Google Workspace组织配置变更：如果使用Workspace服务，管理员可能在后台调整了身份提供商的用户属性暴露规则，限制了locale字段向外输出，可联系Workspace管理员检查相关配置。
• 用户Profile同步异常：即使用户手动设置了公开的locale偏好，Google侧可能存在Profile数据未同步到OIDC身份池的情况，比如用户近期切换登录地区、设备，触发了locale的临时重置但未完成同步。
• 令牌端点或版本差异：确认应用是否无意中切换了OIDC令牌端点（比如从旧版v2切换到v3），不同版本的端点返回的载荷字段可能存在差异。

快速验证方案 #

直接调用Google的UserInfo端点获取用户数据，如果UserInfo中存在locale但ID Token中没有，说明是ID Token的字段过滤问题，可通过调整授权请求的claims参数解决；若UserInfo中也无该字段，则需联系Google支持排查用户Profile或服务端问题。

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